Migration vers un registre externe compatible OCI

Remarque :

Cette étape est requise si vous souhaitez utiliser un registre externe pour les artefacts Automation Suite. Il s'agit de l'approche recommandée et elle améliore l'expérience globale d'utilisation d'Automation Suite en raison de la facilité d'utilisation, de la disponibilité globale, de la sécurité et du contrôle d'accès et de l'intégration.

#	Étape
1.	Mettez à jour le fichier `cluster_config.json` avec les détails du registre externe compatible OCI. Pour plus de détails, consultez Effectuer une configuration avancée.
2.	Copiez le programme d'installation et le fichier `cluster_config.json` sur les autres machines. Voir plus...
3.	Configurez tous les nœuds pour utiliser le registre externe. Voir plus...
4.	Configurez ArgoCD pour utiliser le registre externe. Voir plus...
5.	Cette étape dépend de votre scénario de migration : Si vous migrez d’un registre intégré vers un registre externe lors d’une mise à niveau sur place, suivez les étapes décrites dans la section Exécution de la mise à niveau. Si vous migrez d’un registre intégré au cluster vers un registre externe dans le cadre d’une installation existante, consultez Manuel : Installation d’Automation Suite.
6.	Désinstallez le registre interne. Voir plus...

Copie du programme d'installation et du fichier cluster_config.json sur les autres machines

Si vous configurez le registre externe au moment de la mise à niveau, veillez à ce que le fichier d’installation et le fichier cluster_config.json soient disponibles sur le premier serveur ainsi que sur toutes les autres machines avant de continuer.

Fichiers	Emplacement sur toutes les machines
`as-installer`	`/opt/UiPathAutomationSuite/latest/installer`
`cluster_config.json`	`/opt/UiPathAutomationSuite/cluster_config.json`

Configuration de tous les nœuds pour utiliser le registre externe

Pour configurer les nœuds afin d'utiliser le registre externe, effectuez les étapes suivantes une par une sur tous les nœuds du cluster :

Définissez la variable PATH pour utiliser l'outil uipathctl et accédez au dossier d'installation :
```
export PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/binexport PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/bin
```
```
cd /opt/UiPathAutomationSuite/latest/installercd /opt/UiPathAutomationSuite/latest/installer
```

Vérifiez la connectivité au nouveau registre sur tous les nœuds :

./bin/uipathctl prereq run --location local --included "Registry_Connectivity" /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json./bin/uipathctl prereq run --location local --included "Registry_Connectivity" /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

Mettez à jour la configuration containerd et redémarrez rke2 sur tous les nœuds :

./bin/uipathctl rke2 generate-registries /opt/UiPathAutomationSuite/cluster_config.json --current-config-path /etc/rancher/rke2/registries.yaml > /etc/rancher/rke2/registries.yaml.tmp

mv -f /etc/rancher/rke2/registries.yaml.tmp /etc/rancher/rke2/registries.yaml

systemctl restart rke2-server || systemctl restart rke2-agent./bin/uipathctl rke2 generate-registries /opt/UiPathAutomationSuite/cluster_config.json --current-config-path /etc/rancher/rke2/registries.yaml > /etc/rancher/rke2/registries.yaml.tmp

mv -f /etc/rancher/rke2/registries.yaml.tmp /etc/rancher/rke2/registries.yaml

systemctl restart rke2-server || systemctl restart rke2-agent

Vérifiez que containerd peut extraire des images après la mise à jour de la configuration sur tous les nœuds de serveur :

./bin/uipathctl prereq run --location local --included "Registry_Pull" /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json./bin/uipathctl prereq run --location local --included "Registry_Pull" /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

Configurer ArgoCD pour utiliser le registre externe

Pour configurer ArgoCD afin d'utiliser le registre externe, procédez comme suit :

Mettez à jour la configuration du registre ArgoCD sur n'importe quel nœud de serveur en exécutant les commandes suivantes sur n'importe quel nœud de serveur :

export PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/binexport PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/bin

cd /opt/UiPathAutomationSuite/latest/installercd /opt/UiPathAutomationSuite/latest/installer

Sauvegardez et mettez à jour la configuration du registre. Ceci est nécessaire pour maintenir la connectivité avec l'ancien registre pendant la migration.

kubectl get secret helm-credentials -n argocd -o json | \
 jq '.metadata = {name: "old-helm-credentials", namespace: .metadata.namespace, labels: .metadata.labels}' | \
 kubectl apply -f -

./bin/uipathctl config argocd registry update --host <OCI_registry_host> --username <optional_username> --password <optional_password>kubectl get secret helm-credentials -n argocd -o json | \
 jq '.metadata = {name: "old-helm-credentials", namespace: .metadata.namespace, labels: .metadata.labels}' | \
 kubectl apply -f -

./bin/uipathctl config argocd registry update --host <OCI_registry_host> --username <optional_username> --password <optional_password>

Mettez à jour les certificats CA de confiance, si nécessaire :

./bin/uipathctl config argocd ca-certificates update --cacert rootCA.crt./bin/uipathctl config argocd ca-certificates update --cacert rootCA.crt

Vérifiez qu'ArgoCD peut créer une application vide après la mise à jour de la configuration sur n'importe quel nœud :

./bin/uipathctl health test --versions versions/helm-charts.json --included argocd./bin/uipathctl health test --versions versions/helm-charts.json --included argocd