#安装

#上传并解压安装包

将 Core Package 安装包上传到 global 集群控制平面的任意一台机器上，并按以下命令进行解压：

# Assume that the /root/cpaas-install folder already exists on the machine
tar -xvf {Path to Core Package File}/{Core Package File Name} -C /root/cpaas-install
cd /root/cpaas-install/installer || exit 1

#准备所需的 Aligned Extension 包

将 Required Aligned Extensions 中列出的 8 个包分别复制到解压后的 Core Package 的 plugins/ 目录中。每个包执行一次以下命令：

cp <path-to-extension-package> /root/cpaas-install/installer/plugins/

在启动安装程序之前，请确认该目录中包含这 8 个必需的包：

ls -1 /root/cpaas-install/installer/plugins/

请勿将 Common ACP Extensions 中的其他包复制到该目录。安装程序只会处理你手动放入 plugins/ 中的包；它不会从 Customer Portal 下载包。

#启动安装程序

根据平台镜像源选择对应的命令。安装程序成功启动后，终端会输出 web 控制台访问地址。

等待大约 5 分钟后，你可以使用 PC 上的浏览器访问安装程序提供的 web 控制台。

对于平台内置 Registry：

bash setup.sh

对于允许匿名拉取的外部 Registry：

bash setup.sh --registry "<registry-address>"

对于需要身份验证的外部 Registry，请同时提供拉取用户名和密码。setup.sh 使用的拉取账号可以与用于上传 payload 的推送账号不同：

export REGISTRY_ADDRESS="registry.example.com"
export REGISTRY_USERNAME="<registry-pull-username>"
read -rsp "Registry password: " REGISTRY_PASSWORD
export REGISTRY_PASSWORD
printf '\n'

bash setup.sh \
  --registry "$REGISTRY_ADDRESS" \
  --username "$REGISTRY_USERNAME" \
  --password "$REGISTRY_PASSWORD"

unset REGISTRY_PASSWORD

Registry 地址必须采用 <host-or-IP>[:port] 这种格式，且不要包含 http:// 或 https://。不要只提供 --username 和 --password 中的其中一个。

#IP Family

bash setup.sh --ip-family ipv6

如果你计划创建使用单栈网络 IPv6 的 global 集群，启动安装程序时必须显式指定 --ip-family ipv6。如果不指定该参数，安装程序创建的 global 集群将默认支持单栈网络 IPv4 和双栈网络。

#参数配置

在 Web UI 中配置安装，检查每个值，然后确认安装。有关逐字段说明，请参见 安装程序参数。