从集群内注册表迁移到符合 OCI 的外部注册表

对于 Automation Suite 工件，从集群内注册表迁移到符合 OCI 的外部注册表。

备注：

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

#	步骤
1.	使用符合 OCI 的外部注册表详细信息更新 cluster_config.json 文件。 有关详细信息，请参阅执行高级配置。
2.	将安装程序和 cluster_config.json 复制到其他计算机。 详细信息...
3.	将所有节点配置为使用外部注册表。详细信息...
4.	将 ArgoCD 配置为使用外部注册表。 详细信息...
5.	此步骤取决于您的迁移方案： 如果您在就地升级期间从集群内注册表迁移到外部注册表，请按照执行升级中的步骤操作。 如果您在现有安装中从集群内注册表迁移到外部注册表，请参阅手册：安装 Automation Suite 。
6.	卸载内部注册表。详细信息...

将安装程序和 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. 在所有节点上验证与新注册表的连接：

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

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

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

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

3. 按需更新外部注册表的受信任 CA 证书：

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

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

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