Skip to content

Commit 873d9bb

Browse files
authored
Merge pull request #7717 from ovh/dev/thcdrt/update-mpr-proxy-cache-documentation
Managed Private Registry - Proxy-Cache improvments
2 parents e51b7c1 + a3635ab commit 873d9bb

File tree

15 files changed

+90
-420
lines changed

15 files changed

+90
-420
lines changed

pages/public_cloud/containers_orchestration/managed_private_registry/configure-proxy-cache/guide.de-de.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
22
title: Configuring Proxy Cache on an OVHcloud Managed Private Registry
33
excerpt: 'Find out how to configure Proxy Cache on an OVHcloud Managed Private Registry'
4-
updated: 2025-04-02
4+
updated: 2025-04-03
55
---
66

77
## Objective
88

9-
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**. This improves performance and reduces rate limits imposed by external registries.
9+
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**, **Github Container Registry**, **Quay**, **JFrog Artifactory Registry**, etc. This improves performance and reduces rate limits imposed by external registries.
1010

1111
We **strongly recommend** using a **Docker account** (even a free one) to **avoid rate limits** when pulling images. Without authentication, Docker Hub enforces strict pull limits, which may cause failures when pulling frequently used images.
1212

13-
> [!primary]
14-
> Harbor **only supports proxy caching for Docker Hub and other Harbor registries**. Other container registries are **not supported** for proxy caching.
15-
1613
## Requirements
1714

1815
- A running **[Managed Private Registry](/pages/public_cloud/containers_orchestration/managed_private_registry/creating-a-private-registry)**.
@@ -55,13 +52,13 @@ We **strongly recommend** using a **Docker account** (even a free one) to **avoi
5552

5653
### 3. Configure Docker to use Harbor proxy cache
5754

58-
#### Log in to the Managed Private Registry
55+
#### 3.1 Log in to the Managed Private Registry
5956

6057
```sh
6158
docker login <your-managed-registry-domain> -u <username> -p <password>
6259
```
6360

64-
#### Pull images via proxy cache
61+
#### 3.2 Pull images via proxy cache
6562

6663
Instead of pulling directly from Docker Hub, use your **Private Managed Registry** as an intermediary:
6764

@@ -71,15 +68,6 @@ docker pull <your-managed-registry-domain>/dockerhub-mirror/library/nginx:latest
7168

7269
Harbor will cache the image locally, so subsequent pulls will be much faster and won’t count against Docker Hub rate limits.
7370

74-
## Supported proxy cache registries
75-
76-
Harbor only supports proxy caching for:
77-
78-
- ✅ Docker Hub
79-
- ✅ Harbor registries (another Harbor instance)
80-
81-
Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io, etc.) are not supported for proxy caching.
82-
8371
## Benefits of using proxy cache
8472

8573
- ✅ Avoid Docker Hub rate limits (with authentication).
@@ -89,20 +77,10 @@ Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io,
8977

9078
## Troubleshooting
9179

92-
### 1. Getting "Too Many Requests" errors
80+
### Getting "Too Many Requests" errors
9381

9482
- Ensure you configured Docker Hub authentication in Harbor.
95-
- Log in to Harbor before pulling images:
96-
97-
```bash
98-
docker login <your-managed-registry-domain>
99-
```
100-
101-
### 2. Image not found in proxy cache
102-
103-
- If the image has not been pulled before, Harbor will fetch it from Docker Hub. Try again in a few moments.
104-
- Check the proxy cache project settings in Harbor to ensure it's linked to the correct registry.
10583

10684
## Conclusion
10785

108-
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. However, only Docker Hub and Harbor registries are supported for proxy caching. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.
86+
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.

pages/public_cloud/containers_orchestration/managed_private_registry/configure-proxy-cache/guide.en-asia.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
22
title: Configuring Proxy Cache on an OVHcloud Managed Private Registry
33
excerpt: 'Find out how to configure Proxy Cache on an OVHcloud Managed Private Registry'
4-
updated: 2025-04-02
4+
updated: 2025-04-03
55
---
66

77
## Objective
88

9-
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**. This improves performance and reduces rate limits imposed by external registries.
9+
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**, **Github Container Registry**, **Quay**, **JFrog Artifactory Registry**, etc. This improves performance and reduces rate limits imposed by external registries.
1010

1111
We **strongly recommend** using a **Docker account** (even a free one) to **avoid rate limits** when pulling images. Without authentication, Docker Hub enforces strict pull limits, which may cause failures when pulling frequently used images.
1212

13-
> [!primary]
14-
> Harbor **only supports proxy caching for Docker Hub and other Harbor registries**. Other container registries are **not supported** for proxy caching.
15-
1613
## Requirements
1714

1815
- A running **[Managed Private Registry](/pages/public_cloud/containers_orchestration/managed_private_registry/creating-a-private-registry)**.
@@ -55,13 +52,13 @@ We **strongly recommend** using a **Docker account** (even a free one) to **avoi
5552

5653
### 3. Configure Docker to use Harbor proxy cache
5754

58-
#### Log in to the Managed Private Registry
55+
#### 3.1 Log in to the Managed Private Registry
5956

6057
```sh
6158
docker login <your-managed-registry-domain> -u <username> -p <password>
6259
```
6360

64-
#### Pull images via proxy cache
61+
#### 3.2 Pull images via proxy cache
6562

6663
Instead of pulling directly from Docker Hub, use your **Private Managed Registry** as an intermediary:
6764

@@ -71,15 +68,6 @@ docker pull <your-managed-registry-domain>/dockerhub-mirror/library/nginx:latest
7168

7269
Harbor will cache the image locally, so subsequent pulls will be much faster and won’t count against Docker Hub rate limits.
7370

74-
## Supported proxy cache registries
75-
76-
Harbor only supports proxy caching for:
77-
78-
- ✅ Docker Hub
79-
- ✅ Harbor registries (another Harbor instance)
80-
81-
Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io, etc.) are not supported for proxy caching.
82-
8371
## Benefits of using proxy cache
8472

8573
- ✅ Avoid Docker Hub rate limits (with authentication).
@@ -89,20 +77,10 @@ Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io,
8977

9078
## Troubleshooting
9179

92-
### 1. Getting "Too Many Requests" errors
80+
### Getting "Too Many Requests" errors
9381

9482
- Ensure you configured Docker Hub authentication in Harbor.
95-
- Log in to Harbor before pulling images:
96-
97-
```bash
98-
docker login <your-managed-registry-domain>
99-
```
100-
101-
### 2. Image not found in proxy cache
102-
103-
- If the image has not been pulled before, Harbor will fetch it from Docker Hub. Try again in a few moments.
104-
- Check the proxy cache project settings in Harbor to ensure it's linked to the correct registry.
10583

10684
## Conclusion
10785

108-
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. However, only Docker Hub and Harbor registries are supported for proxy caching. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.
86+
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.

pages/public_cloud/containers_orchestration/managed_private_registry/configure-proxy-cache/guide.en-au.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
22
title: Configuring Proxy Cache on an OVHcloud Managed Private Registry
33
excerpt: 'Find out how to configure Proxy Cache on an OVHcloud Managed Private Registry'
4-
updated: 2025-04-02
4+
updated: 2025-04-03
55
---
66

77
## Objective
88

9-
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**. This improves performance and reduces rate limits imposed by external registries.
9+
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**, **Github Container Registry**, **Quay**, **JFrog Artifactory Registry**, etc. This improves performance and reduces rate limits imposed by external registries.
1010

1111
We **strongly recommend** using a **Docker account** (even a free one) to **avoid rate limits** when pulling images. Without authentication, Docker Hub enforces strict pull limits, which may cause failures when pulling frequently used images.
1212

13-
> [!primary]
14-
> Harbor **only supports proxy caching for Docker Hub and other Harbor registries**. Other container registries are **not supported** for proxy caching.
15-
1613
## Requirements
1714

1815
- A running **[Managed Private Registry](/pages/public_cloud/containers_orchestration/managed_private_registry/creating-a-private-registry)**.
@@ -55,13 +52,13 @@ We **strongly recommend** using a **Docker account** (even a free one) to **avoi
5552

5653
### 3. Configure Docker to use Harbor proxy cache
5754

58-
#### Log in to the Managed Private Registry
55+
#### 3.1 Log in to the Managed Private Registry
5956

6057
```sh
6158
docker login <your-managed-registry-domain> -u <username> -p <password>
6259
```
6360

64-
#### Pull images via proxy cache
61+
#### 3.2 Pull images via proxy cache
6562

6663
Instead of pulling directly from Docker Hub, use your **Private Managed Registry** as an intermediary:
6764

@@ -71,15 +68,6 @@ docker pull <your-managed-registry-domain>/dockerhub-mirror/library/nginx:latest
7168

7269
Harbor will cache the image locally, so subsequent pulls will be much faster and won’t count against Docker Hub rate limits.
7370

74-
## Supported proxy cache registries
75-
76-
Harbor only supports proxy caching for:
77-
78-
- ✅ Docker Hub
79-
- ✅ Harbor registries (another Harbor instance)
80-
81-
Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io, etc.) are not supported for proxy caching.
82-
8371
## Benefits of using proxy cache
8472

8573
- ✅ Avoid Docker Hub rate limits (with authentication).
@@ -89,20 +77,10 @@ Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io,
8977

9078
## Troubleshooting
9179

92-
### 1. Getting "Too Many Requests" errors
80+
### Getting "Too Many Requests" errors
9381

9482
- Ensure you configured Docker Hub authentication in Harbor.
95-
- Log in to Harbor before pulling images:
96-
97-
```bash
98-
docker login <your-managed-registry-domain>
99-
```
100-
101-
### 2. Image not found in proxy cache
102-
103-
- If the image has not been pulled before, Harbor will fetch it from Docker Hub. Try again in a few moments.
104-
- Check the proxy cache project settings in Harbor to ensure it's linked to the correct registry.
10583

10684
## Conclusion
10785

108-
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. However, only Docker Hub and Harbor registries are supported for proxy caching. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.
86+
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.

pages/public_cloud/containers_orchestration/managed_private_registry/configure-proxy-cache/guide.en-ca.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
22
title: Configuring Proxy Cache on an OVHcloud Managed Private Registry
33
excerpt: 'Find out how to configure Proxy Cache on an OVHcloud Managed Private Registry'
4-
updated: 2025-04-02
4+
updated: 2025-04-03
55
---
66

77
## Objective
88

9-
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**. This improves performance and reduces rate limits imposed by external registries.
9+
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**, **Github Container Registry**, **Quay**, **JFrog Artifactory Registry**, etc. This improves performance and reduces rate limits imposed by external registries.
1010

1111
We **strongly recommend** using a **Docker account** (even a free one) to **avoid rate limits** when pulling images. Without authentication, Docker Hub enforces strict pull limits, which may cause failures when pulling frequently used images.
1212

13-
> [!primary]
14-
> Harbor **only supports proxy caching for Docker Hub and other Harbor registries**. Other container registries are **not supported** for proxy caching.
15-
1613
## Requirements
1714

1815
- A running **[Managed Private Registry](/pages/public_cloud/containers_orchestration/managed_private_registry/creating-a-private-registry)**.
@@ -55,13 +52,13 @@ We **strongly recommend** using a **Docker account** (even a free one) to **avoi
5552

5653
### 3. Configure Docker to use Harbor proxy cache
5754

58-
#### Log in to the Managed Private Registry
55+
#### 3.1 Log in to the Managed Private Registry
5956

6057
```sh
6158
docker login <your-managed-registry-domain> -u <username> -p <password>
6259
```
6360

64-
#### Pull images via proxy cache
61+
#### 3.2 Pull images via proxy cache
6562

6663
Instead of pulling directly from Docker Hub, use your **Private Managed Registry** as an intermediary:
6764

@@ -71,15 +68,6 @@ docker pull <your-managed-registry-domain>/dockerhub-mirror/library/nginx:latest
7168

7269
Harbor will cache the image locally, so subsequent pulls will be much faster and won’t count against Docker Hub rate limits.
7370

74-
## Supported proxy cache registries
75-
76-
Harbor only supports proxy caching for:
77-
78-
- ✅ Docker Hub
79-
- ✅ Harbor registries (another Harbor instance)
80-
81-
Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io, etc.) are not supported for proxy caching.
82-
8371
## Benefits of using proxy cache
8472

8573
- ✅ Avoid Docker Hub rate limits (with authentication).
@@ -89,20 +77,10 @@ Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io,
8977

9078
## Troubleshooting
9179

92-
### 1. Getting "Too Many Requests" errors
80+
### Getting "Too Many Requests" errors
9381

9482
- Ensure you configured Docker Hub authentication in Harbor.
95-
- Log in to Harbor before pulling images:
96-
97-
```bash
98-
docker login <your-managed-registry-domain>
99-
```
100-
101-
### 2. Image not found in proxy cache
102-
103-
- If the image has not been pulled before, Harbor will fetch it from Docker Hub. Try again in a few moments.
104-
- Check the proxy cache project settings in Harbor to ensure it's linked to the correct registry.
10583

10684
## Conclusion
10785

108-
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. However, only Docker Hub and Harbor registries are supported for proxy caching. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.
86+
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.

pages/public_cloud/containers_orchestration/managed_private_registry/configure-proxy-cache/guide.en-gb.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
22
title: Configuring Proxy Cache on an OVHcloud Managed Private Registry
33
excerpt: 'Find out how to configure Proxy Cache on an OVHcloud Managed Private Registry'
4-
updated: 2025-04-02
4+
updated: 2025-04-03
55
---
66

77
## Objective
88

9-
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**. This improves performance and reduces rate limits imposed by external registries.
9+
Harbor provides a **proxy cache** feature that helps you mirror and cache images from external registries like **Docker Hub**, **Github Container Registry**, **Quay**, **JFrog Artifactory Registry**, etc. This improves performance and reduces rate limits imposed by external registries.
1010

1111
We **strongly recommend** using a **Docker account** (even a free one) to **avoid rate limits** when pulling images. Without authentication, Docker Hub enforces strict pull limits, which may cause failures when pulling frequently used images.
1212

13-
> [!primary]
14-
> Harbor **only supports proxy caching for Docker Hub and other Harbor registries**. Other container registries are **not supported** for proxy caching.
15-
1613
## Requirements
1714

1815
- A running **[Managed Private Registry](/pages/public_cloud/containers_orchestration/managed_private_registry/creating-a-private-registry)**.
@@ -55,13 +52,13 @@ We **strongly recommend** using a **Docker account** (even a free one) to **avoi
5552

5653
### 3. Configure Docker to use Harbor proxy cache
5754

58-
#### Log in to the Managed Private Registry
55+
#### 3.1 Log in to the Managed Private Registry
5956

6057
```sh
6158
docker login <your-managed-registry-domain> -u <username> -p <password>
6259
```
6360

64-
#### Pull images via proxy cache
61+
#### 3.2 Pull images via proxy cache
6562

6663
Instead of pulling directly from Docker Hub, use your **Private Managed Registry** as an intermediary:
6764

@@ -71,15 +68,6 @@ docker pull <your-managed-registry-domain>/dockerhub-mirror/library/nginx:latest
7168

7269
Harbor will cache the image locally, so subsequent pulls will be much faster and won’t count against Docker Hub rate limits.
7370

74-
## Supported proxy cache registries
75-
76-
Harbor only supports proxy caching for:
77-
78-
- ✅ Docker Hub
79-
- ✅ Harbor registries (another Harbor instance)
80-
81-
Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io, etc.) are not supported for proxy caching.
82-
8371
## Benefits of using proxy cache
8472

8573
- ✅ Avoid Docker Hub rate limits (with authentication).
@@ -89,20 +77,10 @@ Other container registries (e.g. Amazon ECR, Google Container Registry, Quay.io,
8977

9078
## Troubleshooting
9179

92-
### 1. Getting "Too Many Requests" errors
80+
### Getting "Too Many Requests" errors
9381

9482
- Ensure you configured Docker Hub authentication in Harbor.
95-
- Log in to Harbor before pulling images:
96-
97-
```bash
98-
docker login <your-managed-registry-domain>
99-
```
100-
101-
### 2. Image not found in proxy cache
102-
103-
- If the image has not been pulled before, Harbor will fetch it from Docker Hub. Try again in a few moments.
104-
- Check the proxy cache project settings in Harbor to ensure it's linked to the correct registry.
10583

10684
## Conclusion
10785

108-
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. However, only Docker Hub and Harbor registries are supported for proxy caching. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.
86+
Using Harbor's proxy cache helps optimize Docker image pulls, avoiding rate limits and improving performance. Be sure to authenticate with Docker Hub in Harbor to prevent rate limit issues.

0 commit comments

Comments
 (0)