安装

本节介绍如何安装 Core 和所需的 Aligned Extensions,并部署 global 集群。

安装路径

此安装路径适用于运行在非 Alauda OS上的集群。如果您的环境使用 Alauda OS,请改为参阅Alauda OS 上安装 global 集群。

开始安装前,请确保已完成先决条件检查,下载并验证 Core Package 和所需的 Aligned Extension 软件包,完成节点预处理以及其他准备工作。如果您选择了外部平台镜像 Registry,则必须在运行 setup.sh 前准备好完整的目标版本负载。

流程

上传并解压安装包

将 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
信息
  • global 集群安装完成后,此机器将成为第一个控制平面节点。
  • 解压 Core Package 后,至少需要 100GB 的磁盘空间。请确保有足够的存储资源。
  • Core Package 不包含所需的 Aligned Extension 软件包。请按照下载中的说明单独准备这些软件包。

准备所需的 Aligned Extension 软件包

将所需的 Aligned Extensions中列出的八个软件包分别复制到解压后的 Core Package 的 plugins/ 目录中。对每个软件包运行一次以下命令:

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

启动安装程序前,请确认该目录包含所需的八个软件包:

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 使用的拉取账户可以不同于用于上传负载的推送账户:

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 地址和 8080 端口,以便安装程序成功启动后能够顺利访问其提供的 Web 控制台。

IP 系列

bash setup.sh --ip-family ipv6

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

参数配置

在 Web UI 中配置安装,检查每个值,然后确认安装。有关各字段的参考信息,请参阅安装程序参数。

验证安装

安装程序报告安装完成后,在继续执行安装后任务之前,请验证 Core 和所需的 Aligned Extensions。有关检查清单和命令,请参阅验证。

安装程序参数参考

有关字段的详细参考信息,请参阅安装程序参数。

安装故障排除

有关安装程序停滞、失败的资源、镜像拉取失败、缺少构件和清理,请参阅安装故障排除。

其他资源