Revetly
Manual 0.8.0

Connect private git repositories with one credential

Give this instance one credential for the private repositories it reads. The token is set in the environment, never in the committed file.

Before you start

Configuration page

  1. Open the configuration page. If it is not open, run revetly config and open the address it prints.

  2. Go to Instance settings > Git and records.

  3. On the Git credentials row, select Add.

  4. Enter acme in Name.

  5. Enter https://github.com/<ACCOUNT>/ in Repository address. Replace <ACCOUNT> with the forge account holding those repositories.

  6. Enter the token in Token value.

  7. In Token variable, leave REVETLY_GIT_TOKEN.

  8. Select Save.

    You should see Saved and in use.

  9. On the Git credentials line, select Test credential.

    You should see credential acme accepted.

Command line

  1. In revetly.toml at the project root, declare the credential under [git.credentials]:

    # revetly.toml
[git.credentials.acme]
match = "https://github.com/<ACCOUNT>/"

    Replace <ACCOUNT> with the forge account holding those repositories.

  2. Read back what that credential covers:

    revetly doctor --offline

    [FAIL] git credentials acme: https://github.com/<ACCOUNT>/ (read only), REVETLY_GIT_TOKEN is NOT SET

  3. In .env beside it, put the token that line asked for: 

    # .env
REVETLY_GIT_TOKEN=<FORGE_TOKEN>

    Replace <FORGE_TOKEN> with the token from your forge.

  4. Confirm the credential is complete: 

    revetly doctor --offline

    [PASS] git credentials acme: https://github.com/<ACCOUNT>/ (read only), REVETLY_GIT_TOKEN is set

Troubleshooting

Next steps