Migration du registre intégré au cluster vers un registre externe compatible OCI

Migrez du registre intégré au cluster vers un registre externe compatible OCI pour les artefacts Automation Suite.

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 de plus amples informations, consultez la section Effectuer une configuration avancée.
2.	Copiez le programme d'installation et le fichier cluster_config.json sur les autres machines. Plus de détails ici.
3.	Configurez tous les nœuds pour utiliser le registre externe. Plus de détails ici.
4.	Configurez ArgoCD pour utiliser le registre externe. Plus de détails ici.
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 la section Manuel : Installation d’Automation Suite.
6.	Désinstallez le registre interne. Plus de détails ici.

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. Le tableau suivant répertorie les fichiers requis et leurs emplacements attendus.

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 :

1. Définissez la variable PATH pour utiliser l'outil uipathctl et accédez au dossier d'installation :

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

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. 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
   

3. 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
   

4. 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
   

Configuration d'ArgoCD pour utiliser le registre externe

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

1. 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/bin
   

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. 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>
   

3. Mettez à jour les certificats d'autorité de certification de confiance du registre externe, si nécessaire :

   /bin/uipathctl config argocd ca-certificates update --cacert <external-registry-rootCA.crt>
   

4. 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