Skip to content

Commit c3a19b0

Browse files
OVH-Team-GuidesOVH-Team-Guides
authored
Merge pull request #4335 from ovh/ava-eol-harbor
Add EOL harbor 1.10 tuto
2 parents 2c1be99 + 73c4c22 commit c3a19b0

30 files changed

+1692
-0
lines changed

‎pages/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -709,6 +709,7 @@
709709
+ [Connecting to the UI](platform/private-registry/connecting-to-the-ui)
710710
+ [Managing users and projects](platform/private-registry/managing-users-and-projects)
711711
+ [FAQ](platform/private-registry/managed-private-registry-faq)
712+
+ [End Of Life (EOL) Harbor 1.x - How to replicate and migrate your data to Harbor 2.x](platform/private-registry/eol-harbor-1.x)
712713
+ [Tutorials](public-cloud-containers-orchestration-managed-private-registry-tutorials)
713714
+ [Creating and using a Docker image stored in an OVHcloud Managed Private Registry](platform/private-registry/creating-and-using-a-private-image)
714715
+ [Using Private Registry with OVHcloud Managed Kubernetes](platform/private-registry/using-private-registry-with-kubernetes)

‎pages/platform/private-registry/eol-harbor-1.x/guide.de-de.md

Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
---
2+
title: "End Of Life (EOL) Harbor 1.x - How to replicate and migrate your data to Harbor 2.x"
3+
excerpt: "Find out how to replicate an old private registry (in Harbor 1.x) to a recent OVHcloud Managed Private Registry (in Harbor 2.x)"
4+
slug: eol-harbor-v1x
5+
section: 'Getting started'
6+
order: 06
7+
routes:
8+
canonical: 'https://docs.ovh.com/gb/en/private-registry/eol-harbor-1.x/'
9+
updated: 2023-03-10
10+
---
11+
12+
**Last updated 10th March, 2023.**
13+
14+
<style>
15+
pre {
16+
font-size: 14px;
17+
}
18+
pre.console {
19+
background-color: #300A24;
20+
color: #ccc;
21+
font-family: monospace;
22+
padding: 5px;
23+
margin-bottom: 5px;
24+
}
25+
pre.console code {
26+
border: solid 0px transparent;
27+
color: #ccc;
28+
font-family: monospace !important;
29+
font-size: 0.75em;
30+
}
31+
.small {
32+
font-size: 0.75em;
33+
}
34+
</style>
35+
36+
## Objective
37+
38+
The OVHcloud Managed Private Registry service provides you a managed, authenticated Docker registry where you can privately store your Docker images.
39+
40+
Managed Private Registry is built on Open Source solutions such as Docker and the CNCF Harbor project, to guarantee its interoperability.
41+
42+
The Managed Private Registries based on Harbor 1.x will terminate on August 1st 2023. The aim of this guide is to show you how to create a new private registry (based on Harbor 2.x) and migrate your data from your 1.x private registry to this new one.
43+
44+
## Instructions
45+
46+
First, follow the guide [Creating a private registry](https://docs.ovh.com/de/private-registry/creating-a-private-registry/) to create a new private registry named `my-new-registry` for example, with the latest version of Harbor.
47+
48+
![My new private registry](images/my-new-registry-02.png)
49+
50+
Follow the guide [Connecting to the UI](https://docs.ovh.com/gb/en/private-registry/connecting-to-the-ui/) to connect to your new private registry.
51+
52+
Now you will configure a replication between your old private registry (in Harbor 1.x) and the new one.
53+
54+
In the `Administration` menu, click on `Registries`{.action}.
55+
56+
![Create a replication between two registries](images/registries.png){.thumbnail}
57+
58+
Click on `New endpoint`{.action} button to create a replication endpoint.
59+
60+
Now fill the form with the following information:
61+
62+
- Provider: `Harbor`
63+
- Name: `harbor-1.10`
64+
- Endpoint URL: `<your Harbor 1.10 URL (https://xxxxxxxx.grax.container-registry.ovh.net/)>`
65+
- Access ID: `<Harbor 1.10 username>`
66+
- Access secret: `<Harbor 1.10 password>`
67+
68+
![New private registry endpoint](images/new-registry-endpoint.png){.thumbnail}
69+
70+
Click on the button `Test connection`{.action} to ping the private registry and test your information.
71+
72+
![New private registry endpoint](images/connection-tested-ok.png){.thumbnail}
73+
74+
Click on the button `OK`{.action} to save your information.
75+
76+
![New private registry endpoint](images/new-registry-endpoint-created.png){.thumbnail}
77+
78+
In the `Administration` menu, click on `Replications`{.action}.
79+
80+
![Replications](images/replications.png){.thumbnail}
81+
82+
Click on the button `New replication rule`{.action} to create a new rule.
83+
84+
Now fill the form with the following information:
85+
86+
- Name: `harbor-1.10`
87+
- Replication mode: `Pull based`
88+
- Source registry: Select your registry started with `harbor-1.10-*`
89+
- Trigger mode: `Manual` or `Scheduled`
90+
91+
> [!primary]
92+
>
93+
> **Manual**: Replicate the resources manually when needed.
94+
>
95+
> **Scheduled**: Replicate the resources periodically by defining a cron job.
96+
>
97+
> Note: In both cases, deletion operations are not replicated.
98+
99+
![New replicaton rule](images/new-replication-rule.png){.thumbnail}
100+
101+
Click on `Save`{.action} to save your information.
102+
103+
![Replication rule created](images/replication-rule-created.png){.thumbnail}
104+
105+
To run manually a replication rule, select your replication rule and click on the `Replicate`{.action} button.
106+
107+
![Replication rule](images/replicate-button.png){.thumbnail}
108+
109+
Then click on `Replicate`{.action} to run the replication.
110+
111+
![Replication rule](images/are-you-sure.png){.thumbnail}
112+
113+
You should be able to see the status of the replication in the `Executions` section.
114+
115+
First your replication should be in the status `InProgress` and then, after waiting a moment (depending on the size of the data to replicate), the status should change to `Succeeded`.
116+
117+
![Replication rule](images/execution-status.png){.thumbnail}
118+
![Replication rule](images/execution-status-success.png){.thumbnail}
119+
120+
> [!primary]
121+
>
122+
> If you run the same replications several times and you have Helm charts, the replication can fail the second time but it will work.
123+
124+
Finally, you must reconfigure your Harbor instance (users, robot accounts, garbage collection, retention rules, etc.).
125+
Once your registry is replicated, change both the Harbor URL and the credentials in your CI/CD and deployment platform if not already done.
126+
127+
## Go further
128+
129+
To have an overview of OVHcloud Managed Private Registry service, you can consult the [OVHcloud Managed Private Registry site](https://docs.ovh.com/de/private-registry/).
130+
131+
Join our community of users on <https://community.ovh.com/en/>.

‎pages/platform/private-registry/eol-harbor-1.x/guide.en-asia.md

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
---
2+
title: "End Of Life (EOL) Harbor 1.x - How to replicate and migrate your data to Harbor 2.x"
3+
excerpt: "Find out how to replicate an old private registry (in Harbor 1.x) to a recent OVHcloud Managed Private Registry (in Harbor 2.x)"
4+
slug: eol-harbor-v1x
5+
section: "Getting started"
6+
order: 06
7+
updated: 2023-03-10
8+
---
9+
10+
**Last updated 10th March, 2023.**
11+
12+
<style>
13+
pre {
14+
font-size: 14px;
15+
}
16+
pre.console {
17+
background-color: #300A24;
18+
color: #ccc;
19+
font-family: monospace;
20+
padding: 5px;
21+
margin-bottom: 5px;
22+
}
23+
pre.console code {
24+
border: solid 0px transparent;
25+
color: #ccc;
26+
font-family: monospace !important;
27+
font-size: 0.75em;
28+
}
29+
.small {
30+
font-size: 0.75em;
31+
}
32+
</style>
33+
34+
## Objective
35+
36+
The OVHcloud Managed Private Registry service provides you a managed, authenticated Docker registry where you can privately store your Docker images.
37+
38+
Managed Private Registry is built on Open Source solutions such as Docker and the CNCF Harbor project, to guarantee its interoperability.
39+
40+
The Managed Private Registries based on Harbor 1.x will terminate on August 1st 2023. The aim of this guide is to show you how to create a new private registry (based on Harbor 2.x) and migrate your data from your 1.x private registry to this new one.
41+
42+
## Instructions
43+
44+
First, follow the guide [Creating a private registry](https://docs.ovh.com/asia/en/private-registry/creating-a-private-registry/) to create a new private registry named `my-new-registry` for example, with the latest version of Harbor.
45+
46+
![My new private registry](images/my-new-registry-02.png)
47+
48+
Follow the guide [Connecting to the UI](https://docs.ovh.com/asia/en/private-registry/connecting-to-the-ui/) to connect to your new private registry.
49+
50+
Now you will configure a replication between your old private registry (in Harbor 1.x) and the new one.
51+
52+
In the `Administration` menu, click on `Registries`{.action}.
53+
54+
![Create a replication between two registries](images/registries.png){.thumbnail}
55+
56+
Click on `New endpoint`{.action} button to create a replication endpoint.
57+
58+
Now fill the form with the following information:
59+
60+
- Provider: `Harbor`
61+
- Name: `harbor-1.10`
62+
- Endpoint URL: `<your Harbor 1.10 URL (https://xxxxxxxx.grax.container-registry.ovh.net/)>`
63+
- Access ID: `<Harbor 1.10 username>`
64+
- Access secret: `<Harbor 1.10 password>`
65+
66+
![New private registry endpoint](images/new-registry-endpoint.png){.thumbnail}
67+
68+
Click on the button `Test connection`{.action} to ping the private registry and test your information.
69+
70+
![New private registry endpoint](images/connection-tested-ok.png){.thumbnail}
71+
72+
Click on the button `OK`{.action} to save your information.
73+
74+
![New private registry endpoint](images/new-registry-endpoint-created.png){.thumbnail}
75+
76+
In the `Administration` menu, click on `Replications`{.action}.
77+
78+
![Replications](images/replications.png){.thumbnail}
79+
80+
Click on the button `New replication rule`{.action} to create a new rule.
81+
82+
Now fill the form with the following information:
83+
84+
- Name: `harbor-1.10`
85+
- Replication mode: `Pull based`
86+
- Source registry: Select your registry started with `harbor-1.10-*`
87+
- Trigger mode: `Manual` or `Scheduled`
88+
89+
> [!primary]
90+
>
91+
> **Manual**: Replicate the resources manually when needed.
92+
>
93+
> **Scheduled**: Replicate the resources periodically by defining a cron job.
94+
>
95+
> Note: In both cases, deletion operations are not replicated.
96+
97+
![New replicaton rule](images/new-replication-rule.png){.thumbnail}
98+
99+
Click on `Save`{.action} to save your information.
100+
101+
![Replication rule created](images/replication-rule-created.png){.thumbnail}
102+
103+
To run manually a replication rule, select your replication rule and click on the `Replicate`{.action} button.
104+
105+
![Replication rule](images/replicate-button.png){.thumbnail}
106+
107+
Then click on `Replicate`{.action} to run the replication.
108+
109+
![Replication rule](images/are-you-sure.png){.thumbnail}
110+
111+
You should be able to see the status of the replication in the `Executions` section.
112+
113+
First your replication should be in the status `InProgress` and then, after waiting a moment (depending on the size of the data to replicate), the status should change to `Succeeded`.
114+
115+
![Replication rule](images/execution-status.png){.thumbnail}
116+
![Replication rule](images/execution-status-success.png){.thumbnail}
117+
118+
> [!primary]
119+
>
120+
> If you run the same replications several times and you have Helm charts, the replication can fail the second time but it will work.
121+
122+
Finally, you must reconfigure your Harbor instance (users, robot accounts, garbage collection, retention rules, etc.).
123+
Once your registry is replicated, change both the Harbor URL and the credentials in your CI/CD and deployment platform if not already done.
124+
125+
## Go further
126+
127+
To have an overview of OVHcloud Managed Private Registry service, you can consult the [OVHcloud Managed Private Registry site](https://docs.ovh.com/asia/en/private-registry/).
128+
129+
Join our community of users on <https://community.ovh.com/en/>.

‎pages/platform/private-registry/eol-harbor-1.x/guide.en-au.md

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
---
2+
title: "End Of Life (EOL) Harbor 1.x - How to replicate and migrate your data to Harbor 2.x"
3+
excerpt: "Find out how to replicate an old private registry (in Harbor 1.x) to a recent OVHcloud Managed Private Registry (in Harbor 2.x)"
4+
slug: eol-harbor-v1x
5+
section: "Getting started"
6+
order: 06
7+
updated: 2023-03-10
8+
---
9+
10+
**Last updated 10th March, 2023.**
11+
12+
<style>
13+
pre {
14+
font-size: 14px;
15+
}
16+
pre.console {
17+
background-color: #300A24;
18+
color: #ccc;
19+
font-family: monospace;
20+
padding: 5px;
21+
margin-bottom: 5px;
22+
}
23+
pre.console code {
24+
border: solid 0px transparent;
25+
color: #ccc;
26+
font-family: monospace !important;
27+
font-size: 0.75em;
28+
}
29+
.small {
30+
font-size: 0.75em;
31+
}
32+
</style>
33+
34+
## Objective
35+
36+
The OVHcloud Managed Private Registry service provides you a managed, authenticated Docker registry where you can privately store your Docker images.
37+
38+
Managed Private Registry is built on Open Source solutions such as Docker and the CNCF Harbor project, to guarantee its interoperability.
39+
40+
The Managed Private Registries based on Harbor 1.x will terminate on August 1st 2023. The aim of this guide is to show you how to create a new private registry (based on Harbor 2.x) and migrate your data from your 1.x private registry to this new one.
41+
42+
## Instructions
43+
44+
First, follow the guide [Creating a private registry](https://docs.ovh.com/au/en/private-registry/creating-a-private-registry/) to create a new private registry named `my-new-registry` for example, with the latest version of Harbor.
45+
46+
![My new private registry](images/my-new-registry-02.png)
47+
48+
Follow the guide [Connecting to the UI](https://docs.ovh.com/au/en/private-registry/connecting-to-the-ui/) to connect to your new private registry.
49+
50+
Now you will configure a replication between your old private registry (in Harbor 1.x) and the new one.
51+
52+
In the `Administration` menu, click on `Registries`{.action}.
53+
54+
![Create a replication between two registries](images/registries.png){.thumbnail}
55+
56+
Click on `New endpoint`{.action} button to create a replication endpoint.
57+
58+
Now fill the form with the following information:
59+
60+
- Provider: `Harbor`
61+
- Name: `harbor-1.10`
62+
- Endpoint URL: `<your Harbor 1.10 URL (https://xxxxxxxx.grax.container-registry.ovh.net/)>`
63+
- Access ID: `<Harbor 1.10 username>`
64+
- Access secret: `<Harbor 1.10 password>`
65+
66+
![New private registry endpoint](images/new-registry-endpoint.png){.thumbnail}
67+
68+
Click on the button `Test connection`{.action} to ping the private registry and test your information.
69+
70+
![New private registry endpoint](images/connection-tested-ok.png){.thumbnail}
71+
72+
Click on the button `OK`{.action} to save your information.
73+
74+
![New private registry endpoint](images/new-registry-endpoint-created.png){.thumbnail}
75+
76+
In the `Administration` menu, click on `Replications`{.action}.
77+
78+
![Replications](images/replications.png){.thumbnail}
79+
80+
Click on the button `New replication rule`{.action} to create a new rule.
81+
82+
Now fill the form with the following information:
83+
84+
- Name: `harbor-1.10`
85+
- Replication mode: `Pull based`
86+
- Source registry: Select your registry started with `harbor-1.10-*`
87+
- Trigger mode: `Manual` or `Scheduled`
88+
89+
> [!primary]
90+
>
91+
> **Manual**: Replicate the resources manually when needed.
92+
>
93+
> **Scheduled**: Replicate the resources periodically by defining a cron job.
94+
>
95+
> Note: In both cases, deletion operations are not replicated.
96+
97+
![New replicaton rule](images/new-replication-rule.png){.thumbnail}
98+
99+
Click on `Save`{.action} to save your information.
100+
101+
![Replication rule created](images/replication-rule-created.png){.thumbnail}
102+
103+
To run manually a replication rule, select your replication rule and click on the `Replicate`{.action} button.
104+
105+
![Replication rule](images/replicate-button.png){.thumbnail}
106+
107+
Then click on `Replicate`{.action} to run the replication.
108+
109+
![Replication rule](images/are-you-sure.png){.thumbnail}
110+
111+
You should be able to see the status of the replication in the `Executions` section.
112+
113+
First your replication should be in the status `InProgress` and then, after waiting a moment (depending on the size of the data to replicate), the status should change to `Succeeded`.
114+
115+
![Replication rule](images/execution-status.png){.thumbnail}
116+
![Replication rule](images/execution-status-success.png){.thumbnail}
117+
118+
> [!primary]
119+
>
120+
> If you run the same replications several times and you have Helm charts, the replication can fail the second time but it will work.
121+
122+
Finally, you must reconfigure your Harbor instance (users, robot accounts, garbage collection, retention rules, etc.).
123+
Once your registry is replicated, change both the Harbor URL and the credentials in your CI/CD and deployment platform if not already done.
124+
125+
## Go further
126+
127+
To have an overview of OVHcloud Managed Private Registry service, you can consult the [OVHcloud Managed Private Registry site](https://docs.ovh.com/au/en/private-registry/).
128+
129+
Join our community of users on <https://community.ovh.com/en/>.

0 commit comments

Comments
 (0)