Migrieren von der clusterinternen Registrierung zu einer externen OCI-konformen Registrierung

Migrieren Sie von einer clusterinternen Registrierung zu einer externen OCI-konformen Registrierung für eine verbesserte Sicherheit und Verfügbarkeit in der Automation Suite.

Hinweis:

Dieser Schritt ist erforderlich, wenn Sie eine externe Registrierung für die Automation Suite-Artefakte verwenden möchten. Diese Vorgehensweise wird empfohlen und verbessert die allgemeine Erfahrung bei der Verwendung der Automation Suite aufgrund der Benutzerfreundlichkeit, der globalen Verfügbarkeit, der Sicherheit und Zugriffskontrolle sowie der Integration.

Nr.	Schritt
1.	Aktualisieren Sie die Datei cluster_config.json mit den externen OCI-konformen Registrierungsdetails. Weitere Informationen dazu finden Sie unter Durchführen der erweiterten Konfiguration.
2.	Kopieren Sie das Installationsprogramm und cluster_config.json auf die anderen Maschinen. Details…
3.	Konfigurieren Sie alle Knoten für die Verwendung der externen Registrierung. Details…
4.	Konfigurieren Sie ArgoCD so, dass die externe Registrierung verwendet wird. Details…
5.	Dieser Schritt hängt von Ihrem Migrationsszenario ab: Wenn Sie während eines In-Place-Upgrades von einer clusterinternen zu einer externen Registrierung migrieren, führen Sie die Schritte unter Ausführen des Upgrades aus. Wenn Sie in einer vorhandenen Installation von einer clusterinternen zu einer externen Registrierung migrieren möchten, lesen Sie Anleitung: Installieren der Automation Suite.
6.	Deinstallieren Sie die interne Registrierung. Details…

Kopieren des Installationsprogramms und cluster_config.json auf die anderen Maschinen

Wenn Sie die externe Registrierung während des Upgrades konfigurieren, stellen Sie sicher, dass die Installationsdatei und die cluster_config.json-Datei auf dem ersten Server und auf allen anderen Maschinen verfügbar sind, bevor Sie fortfahren.

Dateien	Speicherort auf allen Maschinen
as-installer	/opt/UiPathAutomationSuite/latest/installer
cluster_config.json	/opt/UiPathAutomationSuite/cluster_config.json

Konfigurieren aller Knoten für die Verwendung der externen Registrierung

Um die Knoten für die Verwendung der externen Registrierung zu konfigurieren, führen Sie die folgenden Schritte nacheinander auf allen Knoten im Cluster aus:

1. Legen Sie die Variable PATH fest, um das Tool uipathctl zu verwenden, und navigieren Sie zum Installationsordner:

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

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. Überprüfen Sie die Konnektivität zur neuen Registrierung auf allen Knoten:

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

3. Aktualisieren Sie die Konfiguration containerd und starten Sie rke2 auf allen Knoten neu:

   ./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. Stellen Sie sicher, dass containerd Images nach der Konfigurationsaktualisierung auf allen Serverknoten abrufen kann:

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

Konfigurieren von ArgoCD für die Verwendung der externen Registrierung

Führen Sie die folgenden Schritte aus, um ArgoCD für die Verwendung der externen Registrierung zu konfigurieren:

1. Aktualisieren Sie die ArgoCD-Registrierungskonfiguration auf einem der Serverknoten, indem Sie die folgenden Befehle auf einem beliebigen Serverknoten ausführen:

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

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. Sichern und aktualisieren Sie die Registrierungskonfiguration. Dies ist erforderlich, um die Konnektivität mit der alten Registrierung während der Migration aufrechtzuerhalten.

   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. Aktualisieren Sie bei Bedarf die Zertifikate der vertrauenswürdigen Zertifizierungsstelle der externen Registrierung:

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

4. Stellen Sie sicher, dass ArgoCD nach der Konfigurationsaktualisierung auf einem beliebigen Knoten eine leere Anwendung erstellen kann:

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