Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

First pass at rewriting the tokens/API section. #1732

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

max-allan-cgr
Copy link
Contributor

Signed-off-by: Max Allan max.allan@chainguard.dev

Type of change

Documentation change

What should this PR do?

Fixes some incorrect content on how to get a token.

Why are we making this change?

The suggested method to get a token for private images was incorrect.

What are the acceptance criteria?

Review by docs team.

How should this PR be tested?

Try out the commands proposed.

Signed-off-by: Max Allan <max.allan@chainguard.dev>
Signed-off-by: Max Allan <max.allan@chainguard.dev>
Signed-off-by: Max Allan <max.allan@chainguard.dev>
@max-allan-cgr max-allan-cgr added the documentation Improvements or additions to documentation label Aug 1, 2024
@max-allan-cgr max-allan-cgr requested a review from a team as a code owner August 1, 2024 12:48
Copy link

netlify bot commented Aug 1, 2024

Deploy Preview for ornate-narwhal-088216 ready!

Name Link
🔨 Latest commit 9e1b435
🔍 Latest deploy log https://app.netlify.com/sites/ornate-narwhal-088216/deploys/66ab842f6964af0008b43ea1
😎 Deploy Preview https://deploy-preview-1732--ornate-narwhal-088216.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@amouat amouat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, minor suggestions.

```

To make sure your token is set, you can run the following command:
You may use the `crane` tool to get your token instead:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

```
Where `ORGANIZATION_NAME` is the name of your organization, for example: `company.com`, `IMAGE_NAME` is the name of the image, for example: `chainguard-base` (Note: the image name specified here does not need to be the same image you pass to the API later! But it needs to be a valid image from your registry.)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A little confusing.

Maybe:

Replace ORGANIZATION_NAME andIMAGE_NAME as required. For example, if your organization is foo.com and you're interested in the chainguard-base image:

auth_header="$(crane auth token -H cgr.dev/foo.com/chainguard-base)"

I'm not sure if it's worth mentioning matching image names, just in case it changes.

@amouat
Copy link
Collaborator

amouat commented Aug 1, 2024

There's still a section at the bottom on "enterprise images". I'm not sure if that also needs updated or if we can just delete. Let's not let it get in the way of this fix though.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants