From 3a02c48b3a775780daef4dc186cd4c42d7e44581 Mon Sep 17 00:00:00 2001 From: Ignacio del Valle Alles Date: Thu, 13 Jun 2024 23:36:06 +0200 Subject: [PATCH] GHA doc improvements (#4199) Address feedback from our session --------- Co-authored-by: Vlad A. Ionescu <446771+vladaionescu@users.noreply.github.com> --- docs/cloud/satellites/gha-runners.md | 35 +++++++++++++----- docs/cloud/satellites/gha/token-copy.png | Bin 0 -> 6855 bytes .../cloud/satellites/gha/token-expiration.png | Bin 0 -> 5523 bytes docs/cloud/satellites/gha/token-generate.png | Bin 0 -> 2117 bytes docs/cloud/satellites/gha/token-name.png | Bin 0 -> 4999 bytes 5 files changed, 26 insertions(+), 9 deletions(-) create mode 100644 docs/cloud/satellites/gha/token-copy.png create mode 100644 docs/cloud/satellites/gha/token-expiration.png create mode 100644 docs/cloud/satellites/gha/token-generate.png create mode 100644 docs/cloud/satellites/gha/token-name.png diff --git a/docs/cloud/satellites/gha-runners.md b/docs/cloud/satellites/gha-runners.md index 2082adaaf2..e7f0064842 100644 --- a/docs/cloud/satellites/gha-runners.md +++ b/docs/cloud/satellites/gha-runners.md @@ -17,22 +17,39 @@ These runners come with the Earthly CLI preinstalled and configured to use the s Satellite-based GitHub Actions runners can be enabled for a particular repository or for all repositories of a GitHub organization at once. -The integration process requires you to provide us with a GitHub token, so we can: +The integration process requires you to be a GitHub organization or repository admin, and to provide us with a GitHub token, so we can: - register a webhook in your GitHub repository/organization to receive events associated to GitHub Actions jobs - create GitHub self-hosted runners on demand, to process your repository/organization jobs Follow the next steps to create such integrations: ### 1. Create a GitHub token -Both GitHub classic and fine-grained tokens are supported, but depending on the type of installation (organization-wide or single-repository), the provided token requires different scopes: -| Integration type | User type | Classic token scopes | Fine-grained token permissions | -|------------------|--------------------|-------------------------------|----------------------------------------------------------------------| -| Organization | Organization admin | `admin:org_hook`, `admin:org` | `organization_hooks:write`, `organization_self_hosted_runners:write` | -| Repository | Repository admin | `admin:repo_hook`, `repo` | `repository_hooks:write`, `administration:write` | +- Go to [GitHub's new token page](https://github.com/settings/tokens/new) to create a new GitHub classic token. + +- Give a name to your token that clearly shows its purpose, for example: + + ![token name](./gha/token-name.png) + +- Set the token as non-expiring (notice that the integration won't work after the token expires) + + ![token expiration](./gha/token-expiration.png) + +- Check the following scopes: + - For organization integrations: `admin:org`,`admin:org_hook` + - Alternatively, for repository integrations: `repo`,`admin:repo_hook` + +- Click "generate token" + + ![token generate](./gha/token-generate.png) + +- Copy the token value to use it in the following step + + ![token copy](./gha/token-copy.png) {% hint style='info' %} -Follow the [official docs](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) for detailed information on how to create a GitHub token, and make sure to set an expiration long enough, since the integration won't work after the token expires. +Alternatively, if you prefer creating a fine-grained token, make sure to set the following permissions for it: org: `organization_hooks:write`, `organization_self_hosted_runners:write`, repo: `repository_hooks:write`, `administration:write` +and an expiration time long enough, since the integration won't work after the token expires. {% endhint %} ### 2. Register the integration via CLI @@ -81,8 +98,8 @@ docker run --privileged \ -v /var/run/docker.sock:/var/run/docker.sock \ -v satellite-cache:/tmp/earthly:rw \ -p 8372:8372 \ - -e EARTHLY_TOKEN= \ - -e EARTHLY_ORG= \ + -e EARTHLY_TOKEN= \ + -e EARTHLY_ORG= \ -e SATELLITE_NAME= \ -e SATELLITE_HOST= \ -e RUNNER_GHA_ENABLED=true \ diff --git a/docs/cloud/satellites/gha/token-copy.png b/docs/cloud/satellites/gha/token-copy.png new file mode 100644 index 0000000000000000000000000000000000000000..7e22005575c3e85dc3bd69bea0674ac5f2b2ac0c GIT binary patch literal 6855 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 HO#=T1rU1yd literal 0 HcmV?d00001 diff --git a/docs/cloud/satellites/gha/token-expiration.png b/docs/cloud/satellites/gha/token-expiration.png new file mode 100644 index 0000000000000000000000000000000000000000..2ad7c43e44b94f208864b225614a36f1e6bebf43 GIT binary patch literal 5523 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 literal 0 HcmV?d00001 diff --git a/docs/cloud/satellites/gha/token-name.png b/docs/cloud/satellites/gha/token-name.png new file mode 100644 index 0000000000000000000000000000000000000000..3161f2edba761328c6353d6c1e49e294e4defa0f GIT binary patch literal 4999 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 E0u5fQ)c^nh literal 0 HcmV?d00001