Skip to content

Commit 0b4ab06

Browse files
authored
referencing public images with creds
1 parent cad71f2 commit 0b4ab06

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

docs/vendor/packaging-public-images.mdx

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,15 @@ For more information about the Replicated proxy registry, see [About the Replica
88

99
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 (either `proxy.replicated.com` or your custom domain) instead of multiple registry domains.
1010

11-
For public images, you can use anonymous access without configuring registry credentials.
11+
For public images, you need to first configure registry credentials.
1212

1313
To pull public images through the Replicated proxy registry, use the following `docker` command:
1414

1515
```bash
16-
docker pull REPLICATED_PROXY_DOMAIN/anonymous/UPSTREAM_REGISTRY_HOSTNAME/IMAGE:TAG
16+
docker pull REPLICATED_PROXY_DOMAIN/proxy/APPSLUG/UPSTREAM_REGISTRY_HOSTNAME/IMAGE:TAG
1717
```
1818
Where:
19+
* `APPSLUG` is your Replicated app slug found on the [app settings page](https://vendor.replicated.com/settings).
1920
* `REPLICATED_PROXY_DOMAIN` is `proxy.replicated.com` or your custom domain. For information about how to set a custom domain for the proxy registry, see [Using Custom Domains](/vendor/custom-domains-using).
2021
* `UPSTREAM_REGISTRY_HOSTNAME` is the hostname for the public registry where the image is located. If the image is located in a namespace within the registry, include the namespace after the hostname. For example, `quay.io/namespace`.
2122
* `IMAGE` is the image name.
@@ -31,28 +32,28 @@ The following examples show how to pull public images from DockerHub:
3132

3233
```bash
3334
# DockerHub is the default when no hostname is specified
34-
docker pull proxy.replicated.com/anonymous/busybox
35-
docker pull proxy.replicated.com/anonymous/nginx:1.16.0
35+
docker pull proxy.replicated.com/proxy/APPSLUG/busybox
36+
docker pull proxy.replicated.com/proxy/APPSLUG/nginx:1.16.0
3637
```
3738
```bash
3839
# You can also optionally specify docker.io
39-
docker pull proxy.replicated.com/anonymous/docker.io/replicated/replicated-sdk:1.0.0
40+
docker pull proxy.replicated.com/proxy/APPSLUG/docker.io/replicated/replicated-sdk:1.0.0
4041
```
4142

4243
### Pull Images from Other Registries
4344

4445
The following example shows how to pull images from the Amazon ECR Public Gallery:
4546

4647
```bash
47-
docker pull proxy.replicated.com/anonymous/public.ecr.aws/nginx/nginx:latest
48+
docker pull proxy.replicated.com/proxy/APPSLUG/public.ecr.aws/nginx/nginx:latest
4849
```
4950

5051
### Pull Images Using a Custom Domain for the Proxy Registry
5152

5253
The following example shows how to pull a public image when a custom domain is configured for the proxy registry:
5354

5455
```bash
55-
docker pull my.customdomain.io/anonymous/public.ecr.aws/nginx/nginx:latest
56+
docker pull my.customdomain.io/proxy/APPSLUG/public.ecr.aws/nginx/nginx:latest
5657
```
5758
For information about how to set a custom domain for the proxy registry, see [Using Custom Domains](/vendor/custom-domains-using).
5859

0 commit comments

Comments
 (0)