Migrieren zu einer externen OCI-konformen Registrierung

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 finden Sie unter Durchführen der erweiterten Konfiguration.
2.	Kopieren Sie das Installationsprogramm und cluster_config.json auf die anderen Maschinen.
3.	Konfigurieren Sie alle Knoten für die Verwendung der externen Registrierung.
4.	Konfigurieren Sie ArgoCD so, dass die externe Registrierung verwendet wird.
5.	Deinstallieren Sie die interne Registrierung.

Kopieren des Installationsprogramms und cluster_config.json auf die anderen Maschinen

Wenn Sie die externe Registrierung während des Upgrades konfigurieren, müssen Sie die Installationsdatei und cluster_config.json vom ersten Server auf alle anderen Maschinen kopieren, 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:

   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:

   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:

   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 -
   
   uipathctl config argocd registry update --host <OCI_registry_host> --username <optional_username> --password <optional_password>

3. Aktualisieren Sie bei Bedarf die vertrauenswürdigen Zertifikate von Zertifizierungsstellen:

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

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

   uipathctl health test --versions versions.json --included argocd