Skip to content

Commit 907cf3c

Browse files
authored
Updating cloudsmith screenshots (#3054)
[ x ] Check if this is a typo or other quick fix and ignore the rest :) resolves chainguard-dev/internal#5729 Signed-off-by: Mark Drake <mark@chainguard.dev>
1 parent d6b3357 commit 907cf3c

6 files changed

Lines changed: 11 additions & 12 deletions

File tree

76.1 KB
Loading
52.6 KB
Loading
221 KB
Loading
54.6 KB
Loading
81.6 KB
Loading

content/chainguard/chainguard-images/chainguard-registry/pull-through-guides/cloudsmith-pull-through/index.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -35,27 +35,26 @@ In order to complete this tutorial, you will need the following:
3535

3636
Chainguard's [Free container images](/chainguard/chainguard-images/about/images-categories/#starter-containers) are free to use, publicly available, and always represent versions tagged as `:latest`.
3737

38-
To set up a remote repository in Cloudsmith through which you can pull Free container images, log in to the [Cloudsmith App](https://cloudsmith.io/user/login/). Once there, navigate to the **Repositories** tab and and click the **+ Create Repository** button.
38+
To set up a remote repository in Cloudsmith through which you can pull Free container images, log in to the [Cloudsmith App](https://cloudsmith.io/user/login/). Once there, navigate to the **Repositories** tab and and click **+ Create Repository**.
3939

40-
A modal window will appear where you can enter the following details for your new remote repository:
40+
A window will appear where you can enter the following details for your new remote repository:
4141

4242
* **Name** — This is used to refer to your repository. You can choose whatever name you like here, but this guide's examples will use the name `chainguard-public`.
4343
* **Storage Region** — Here, select the region closest to your location.
44-
* **Repository Type** — This setting determines how the repository can be accessed. You can select **Public**, **Private**, or **Open-Source**.
4544

46-
![Screenshot of the Cloudsmith "Create Your Repository" window. It includes a "Name" field with the value "chainguard-public", the "Storage Region" field set to "Oregon, United States", and "Private" selected as the "Repository Type".](cloudsmith-1.png)
45+
![Screenshot of the Cloudsmith "Create Your Repository" window. It includes a "Name" field with the value "chainguard-public", the "Storage Region" field set to "Oregon, United States".](cloudsmith-1.png)
4746

4847
Following that, you will need to set an [upstream proxy](https://help.cloudsmith.io/docs/upstream-proxying-caching) for this repository. This is what will let Cloudsmith know where to pull container images from.
4948

50-
In the lower left-hand navigation menu, select **Upstream Proxying**. From there, click the **➕ Create Upstream** button and select **Docker** as the upstream source. This will open a modal window where you can enter the details for the upstream source:
49+
In the lower left-hand navigation menu, select **Upstream Proxying**. From there, click **➕ Create Upstream** and select **Docker** as the upstream source. This will open a window where you can enter the details for the upstream source:
5150

52-
![Screenshot of the Cloudsmith "Create Docker Upstream Source" window. It shows a "Name" field with the value "Chainguard Public Upstream", the "Priority" set to "1", the "Upstream URL" set to "https://cgr.dev/chainguard", and the "Cache and Proxy" radial button selected under the "Mode" options.](cloudsmith-2.png)
51+
![Screenshot of the Cloudsmith "Create Docker Upstream Source" window. It shows a "Name" field with the value "Chainguard Public Upstream", the "Priority" set to "1", the "Proxy URL" set to "https://cgr.dev/chainguard", and the "Cache and Proxy" selected under the "Mode" options.](cloudsmith-2.png)
5352

5453
This window has a few fields for which you need to enter values. The **Name** field can include any name you'd like for the upstream source, but it can be helpful to choose something descriptive. In our example the name is "Chainguard Public Upstream." Likewise, you can choose whatever **Priority** value you prefer. This dictates the order in which requests are resolved, with `1` being resolved first, `2` second, and so on.
5554

56-
The most important field in this window is the **Upstream URL** value. In order to use Cloudsmith as a pull through cache for Free images, this **must** be set to `https://cgr.dev/chainguard`.
55+
The most important field in this window is the **Proxy URL** value. In order to use Cloudsmith as a pull through cache for Free images, this **must** be set to `https://cgr.dev/chainguard`.
5756

58-
Lastly, be sure that the **Mode** is set to **Cache and Proxy** and the **Verify SSL Certificates** option is selected. Then, click the **Create Docker Upstream** button.
57+
Lastly, be sure that the **Mode** is set to **Cache and Proxy** and the **Verify SSL Certificates** option is selected. Then, click **Create upstream proxy**.
5958

6059
If you entered all the details correctly, then the upstream proxy will be created successfully and you can test pulling a Free container image through Cloudsmith.
6160

@@ -80,7 +79,7 @@ Be sure to replace `<cloudsmith-organization>` and `<cloudsmith-repository>` wit
8079

8180
If everything worked correctly, the image will appear in your repository:
8281

83-
![Screenshot of a portion of a Cloudsmith "Repository" page showing three nginx packages.](cloudsmith-3.png)
82+
![Screenshot of a portion of a Cloudsmith "Repository" page showing five python packages.](cloudsmith-3.png)
8483

8584
If you run into issues pulling images like this, ensure that your `docker pull` command specifies the correct Cloudsmith organization and repository.
8685

@@ -111,15 +110,15 @@ This command will prompt you to select an organization. Be sure to select the or
111110

112111
This will create a pull token and print a `docker login` command that can be run in a CI environment to log in with the token. This command includes both `--username` and `--password` arguments. You don't need to run this `docker login` command, but you will need the username and password values in a moment so note them down.
113112

114-
Following that, you'll need to create another upstream source. Return to the Cloudsmith web app and navigate to the **Upstream Proxying** page. Click the **➕ Create Upstream** button and select **Docker** as the upstream source. Again, set a **Name** and **Priority** level for this source and ensure that the **Mode** is set to **Cache and Proxy**.
113+
Following that, you'll need to create another upstream source. Return to the Cloudsmith web app and navigate to the **Upstream Proxying** page. Click **➕ Create Upstream** and select **Docker** as the upstream source. Again, set a **Name** and **Priority** level for this source and ensure that the **Mode** is set to **Cache and Proxy**.
115114

116115
When pulling from a private registry through Chainguard, the **Upstream URL** must be set to `https://cgr.dev/`; any other URL here will cause an error.
117116

118117
Lastly, you need to add the username and password you received when you generated the pull token to the upstream source. To do this, expand the **Authentication** section and under **Method** select **Username and Password**. Then enter the username and password you noted down earlier in their respective fields.
119118

120-
![Screenshot of the Cloudsmith "Create Docker Upstream Source" window. It shows a "Name" field with the value "Chainguard Public Upstream", the "Priority" set to "1", the "Upstream URL" set to "https://cgr.dev/", and the "Cache and Proxy" radial button selected under the "Mode" options. Additionally, the "Authentication" section has been expanded, with the "Username and Password" method selected and values entered into the "Username" and "Password" fields.](cloudsmith-4.png)
119+
![Screenshot of the Cloudsmith "Create Docker Upstream Source" window. It shows a "Name" field with the value "Chainguard Private", the "Priority" set to "1", the "Proxy URL" set to "https://cgr.dev/", and "Cache and Proxy" selected under the "Mode" options. Additionally, the "Authentication" section has been expanded, with the "Username and Password" method selected and values entered into the "Username" and "Password" fields.](cloudsmith-4.png)
121120

122-
Finally, click the **Create Docker Upstream** button. With that, you're ready to test a Chainguard Production Container through Cloudsmith.
121+
Finally, click **Create upstream proxy**. With that, you're ready to test a Chainguard Production Container through Cloudsmith.
123122

124123

125124
### Testing pull through of a Chainguard Production Container:

0 commit comments

Comments
 (0)