Migrar a un registro externo compatible con OCI

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.
3.	Configura todos los nodos para utilizar el registro externo.
4.	Configura ArgoCD para utilizar el registro externo.
5.	Desinstala el registro interno.

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

Si configuras el registro externo durante la actualización, debes copiar el archivo del instalador y cluster_config.json del primer servidor a 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:

   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:

   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:

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

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

3. Actualiza los certificados de CA de confianza, si es necesario:

   uipathctl config argocd ca-certificates update --cacert 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:

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