Skip to content

Commit 832c77e

Browse files
committed
Reorg a little bit
1 parent 7370ae6 commit 832c77e

File tree

4 files changed

+51
-49
lines changed

4 files changed

+51
-49
lines changed

docs/vendor/packaging-private-images.md

Lines changed: 0 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -249,54 +249,6 @@ For example:
249249
replicated registry test index.docker.io --image my-company/my-image:v1.2.3
250250
```
251251

252-
## Pull public images through the Replicated proxy registry
253-
254-
You can use the Replicated proxy registry to pull both public and private images. Using the Replicated proxy registry for public images can simplify network access requirements for your customers, as they only need to whitelist a single domain (`proxy.replicated.com` or your custom domain) instead of multiple registry domains.
255-
256-
For public images, you can use anonymous access without configuring registry credentials. The URL structure for pulling public images is:
257-
258-
```
259-
proxy.replicated.com/anonymous/<upstream registry hostname>/<image>:<tag>
260-
```
261-
262-
### Examples
263-
264-
Login with license credentials:
265-
266-
```
267-
# If you have not configured a custom domain, use proxy.replicated.com
268-
docker login proxy.replicated.com -u <CUSTOMER_LICENSE_EMAIL> -p <LICENSE_ID>
269-
270-
# If you have configured a custom proxy domain, use it instead of proxy.replicated.com
271-
docker login {your proxy custom domain} -u <CUSTOMER_LICENSE_EMAIL> -p <LICENSE_ID>
272-
```
273-
274-
Pull public images from DockerHub (default registry when no registry hostname is specified):
275-
```bash
276-
# DockerHub/index.docker.io is the default when no registry hostname is specified
277-
docker pull proxy.replicated.com/anonymous/busybox
278-
docker pull proxy.replicated.com/anonymous/nginx:1.16.0
279-
280-
# You can also explicitly specify docker.io
281-
docker pull proxy.replicated.com/anonymous/docker.io/replicated/replicated-sdk:1.0.0
282-
```
283-
284-
Pull public images from other registries:
285-
```bash
286-
# Pull from Amazon ECR Public Gallery
287-
docker pull proxy.replicated.com/anonymous/public.ecr.aws/nginx/nginx:latest
288-
```
289-
290-
If you have configured a custom domain for your proxy registry, replace `proxy.replicated.com` with your custom domain in the examples above:
291-
292-
```bash
293-
docker pull {your proxy custom domain}/anonymous/public.ecr.aws/nginx/nginx:latest
294-
```
295-
296-
:::note
297-
For private registries or when you need to use specific credentials for quasi-public registries, configure the registry as an external registry first and use `/proxy/` instead of `/anonymous/` in the URL path.
298-
:::
299-
300252
## Related Topic
301253

302254
[Tutorial: Using ECR for Private Images](tutorial-ecr-private-images)
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Connecting to an Public Registry
2+
3+
This topic describes how to pull images from public registries using the Replicated proxy registry. This can simplify network access requirements for your customers, as they only need to allowlist a single domain (`proxy.replicated.com` or your custom domain) instead of multiple registry domains.
4+
5+
For more information about the Replicated proxy registry, see [About the Replicated Proxy Registry](private-images-about).
6+
7+
## Pull public images through the Replicated proxy registry
8+
9+
You can use the Replicated proxy registry to pull both public and private images. Using the Replicated proxy registry for public images can simplify network access requirements for your customers, as they only need to whitelist a single domain (`proxy.replicated.com` or your custom domain) instead of multiple registry domains.
10+
11+
For public images, you can use anonymous access without configuring registry credentials. The URL structure for pulling public images is:
12+
13+
```
14+
proxy.replicated.com/anonymous/<upstream registry hostname>/<image>:<tag>
15+
```
16+
17+
### Pulling images
18+
19+
Pull public images from DockerHub (default registry when no registry hostname is specified):
20+
21+
```bash
22+
# DockerHub/index.docker.io is the default when no registry hostname is specified
23+
docker pull proxy.replicated.com/anonymous/busybox
24+
docker pull proxy.replicated.com/anonymous/nginx:1.16.0
25+
26+
# You can also explicitly specify docker.io
27+
docker pull proxy.replicated.com/anonymous/docker.io/replicated/replicated-sdk:1.0.0
28+
```
29+
30+
Pull public images from other registries:
31+
32+
```bash
33+
# Pull from Amazon ECR Public Gallery
34+
docker pull proxy.replicated.com/anonymous/public.ecr.aws/nginx/nginx:latest
35+
```
36+
37+
If you have configured a custom domain for your proxy registry, replace `proxy.replicated.com` with your custom domain in the examples above:
38+
39+
```bash
40+
docker pull {your proxy custom domain}/anonymous/public.ecr.aws/nginx/nginx:latest
41+
```
42+
43+
:::note
44+
When you need to use specific credentials for quasi-public registries, configure the registry as an private external registry first and use `/proxy/` instead of `/anonymous/` in the URL path.
45+
:::
46+
47+
## Related Topic
48+
49+
[Connecting to an External Registry](packaging-private-images)

docs/vendor/private-images-about.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# About the Replicated Proxy Registry
22

3-
This topic describes how the Replicated proxy registry can be used to grant proxy access to your application's private images.
3+
This topic describes how the Replicated proxy registry can be used to grant proxy access to your application's private images or allow pull through access of public images.
44

55
## Overview
66

sidebars.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -592,6 +592,7 @@ const sidebars = {
592592
'vendor/packaging-private-registry-security',
593593
],
594594
},
595+
'vendor/packaging-public-images',
595596
'vendor/tutorial-ecr-private-images',
596597
],
597598
},

0 commit comments

Comments
 (0)