Skip to content

Commit 28b9c5a

Browse files
authored
more detailed instructions for using github container registry
1 parent 3ac3d74 commit 28b9c5a

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/testing.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,13 @@ Container images generated for all builds are pushed to the [GitHub container re
4343
Containers built by a PR and stored on GitHub Container Registry can be tested locally:
4444

4545
1. [Authenticate to the GitHub Container Registry using a personal access token](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-with-a-personal-access-token-classic).
46+
- Create a [classic token](https://github.com/settings/tokens). Select the scope for `read:packages`
47+
- Copy the newly created token text.
48+
- **On Windows**
49+
- create an Environment Variable to store the token (e.g. GITHUB_TOKEN)
50+
- open powershell
51+
- run the command `echo $env:GITHUB_TOKEN | docker login ghcr.io -u <your particular email> --password-stdin`
52+
- ensure that you get a successful login message. use `docker logout ghcr.io` once the following steps are complete and consider removing the token from github if its no longer needed
4653
2. In the terminal, navigate to `[/docs/test-ghcr-tag`](/docs/test/ghcr-tag).
4754
3. Edit the [`.env` file](/docs/test-ghcr-tag/.env) to specify the PR-based tag (in the form `pr-####`) to test.
4855
4. Run `docker compose up -d`.

0 commit comments

Comments
 (0)