迁移到符合 OCI 的外部注册表

备注：

如果要对 Automation Suite 工件使用外部注册表，则需要执行此步骤。推荐使用此方法，该方法改善了使用 Automation Suite 的整体体验，因为其具有易用性、全局可用性、安全性和访问控制以及集成性。

#	步骤
1.	使用符合 OCI 的外部注册表详细信息更新 cluster_config.json 文件。 有关详细信息，请参阅执行高级配置。
2.	将安装程序和 cluster_config.json 复制到其他计算机。
3.	配置所有节点以使用外部注册表。
4.	将 ArgoCD 配置为使用外部注册表。
5.	卸载内部注册表。

将安装程序和 cluster_config.json 复制到其他计算机

如果在升级过程中配置外部注册表，则必须将安装程序文件和 cluster_config.json 从第一台服务器复制到所有其他计算机，然后再继续。

文件	在所有计算机上的位置
as-installer	/opt/UiPathAutomationSuite/latest/installer
cluster_config.json	/opt/UiPathAutomationSuite/cluster_config.json

将所有节点配置为使用外部注册表

要将节点配置为使用外部注册表，请在集群中的所有节点上逐一执行以下步骤：

1. 设置路径变量以使用 uipathctl 工具，并导航到安装程序文件夹：

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

   cd /opt/UiPathAutomationSuite/latest/installer

2. 在所有节点上验证与新注册表的连接：

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

3. 更新 containerd 配置并在所有节点上重新启动 rke2：

   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. 验证 containerd 是否可以在所有服务器节点上的配置更新后拉取映像：

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

将 ArgoCD 配置为使用外部注册表

要将 ArgoCD 配置为使用外部注册表，请执行以下步骤：

1. 通过在任意服务器节点上运行以下命令，更新任意服务器节点上的 ArgoCD 注册表配置：

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

   cd /opt/UiPathAutomationSuite/latest/installer

2. 备份并更新注册表配置。为在迁移期间保持与旧注册表的连接，此为必要操作。

   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. 按需更新受信任的 CA 证书：

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

4. 在任意节点上更新配置后，验证 ArgoCD 是否可以创建空应用程序：

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