Migrar del registro en clúster a un registro externo compatible con OCI

Migre de un registro en clúster a un registro externo compatible con OCI para mejorar la seguridad y la disponibilidad en Automation Suite.

Nota:

Este paso es necesario si quieres utilizar un registro externo para los artefactos de Automation Suite. Este es el enfoque recomendado y mejora la experiencia general de uso de Automation Suite debido a la facilidad de uso, la disponibilidad global, la seguridad y el control de acceso y la integración.

#	Paso
1.	Actualiza el archivo cluster_config.json con los detalles de registro externo compatible con OCI. Para obtener más información, consulta Realizar configuración avanzada.
2.	Copia el instalador y cluster_config.json en las otras máquinas. Detalles...
3.	Configura todos los nodos para utilizar el registro externo. Detalles...
4.	Configura ArgoCD para utilizar el registro externo. Detalles...
5.	Este paso depende de tu escenario de migración: Si migras de un clúster a un registro externo durante una actualización local, sigue los pasos descritos en Ejecutar la actualización. Si migras de un registro en clúster a un registro externo en una instalación existente, consulta Manual: instalar Automation Suite.
6.	Desinstala el registro interno. Detalles...

Copiar el instalador y cluster_config.json a las otras máquinas

Si configuras el registro externo durante la actualización, asegúrate de que el archivo cluster_config.json y el archivo de instalador estén disponibles en el primer servidor y en todas las demás máquinas antes de continuar.

Archivos	Ubicación en todas las máquinas
as-installer	/opt/UiPathAutomationSuite/latest/installer
cluster_config.json	/opt/UiPathAutomationSuite/cluster_config.json

Configurar todos los nodos para usar el registro externo

Para configurar los nodos para utilizar el registro externo, sigue los siguientes pasos uno a uno en todos los nodos del clúster:

1. Establece la variable PATH para usar la herramienta uipathctl y navega hasta la carpeta del instalador:

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

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. Verificar la conectividad al nuevo registro en todos los nodos:

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

3. Actualiza la configuración de containerd y reinicia rke2 en todos los nodos:

   ./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. Verifica que containerd pueda extraer imágenes después de la actualización de la configuración en todos los nodos del servidor:

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

Configurar ArgoCD para utilizar el registro externo

Para configurar ArgoCD para utilizar el registro externo, sigue los siguientes pasos:

1. Actualiza la configuración del registro de ArgoCD en cualquiera de los nodos del servidor ejecutando los siguientes comandos en cualquier nodo del servidor:

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

   cd /opt/UiPathAutomationSuite/latest/installer
   

2. Haz una copia de seguridad y actualiza la configuración del registro. Esto es necesario para mantener la conectividad con el registro antiguo durante la migración.

   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. Actualiza los certificados de CA de confianza del registro externo, si es necesario:

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

4. Verifica que ArgoCD pueda crear una aplicación vacía después de la actualización de la configuración en cualquier nodo:

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