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.Ver más...
3.	Configura todos los nodos para utilizar el registro externo.Ver más...
4.	Configura ArgoCD para utilizar el registro externo.Ver más...
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 el clúster a un registro externo en una instalación existente, consulta Manual: instalar Automation Suite.
6.	Desinstala el registro interno. Ver más...

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:

Establece la variable PATH para usar la herramienta uipathctl y navega hasta la carpeta del instalador:
```
export PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/binexport PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/bin
```
```
cd /opt/UiPathAutomationSuite/latest/installercd /opt/UiPathAutomationSuite/latest/installer
```

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./bin/uipathctl prereq run --location local --included "Registry_Connectivity" /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

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

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

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/binexport PATH=$PATH:/opt/UiPathAutomationSuite/latest/installer/bin

cd /opt/UiPathAutomationSuite/latest/installercd /opt/UiPathAutomationSuite/latest/installer

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

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

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

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./bin/uipathctl health test --versions versions/helm-charts.json --included argocd