Alauda Container Platform
简体中文

安装

本节描述了安装 global 集群的具体步骤。

在开始安装之前，请确保您已完成先决条件检查、安装包下载与验证、节点预处理及其他准备工作。

目录

过程

上传并解压安装包

将安装包上传到 global 集群控制平面节点的任意机器上，并根据以下命令解压安装包：

# 假设机器上已经存在 /root/cpaas-install 文件夹
tar -xvf {Installation Package File} 的路径/{Installation Package File Name} -C /root/cpaas-install
cd /root/cpaas-install/installer || exit 1
信息
  • 此机器将在 global 集群安装完成后成为第一个控制平面节点。
  • 解压安装包后，至少需要 100GB 的磁盘空间，请确保存储资源充足。

启动安装程序

执行以下安装脚本以启动安装程序。安装程序成功启动后，命令行终端将输出 UI 访问地址。

等待大约 5 分钟后，您可以在 PC 上使用浏览器访问安装程序提供的 Web UI。

bash setup.sh

安装程序默认使用 Kube-OVN 网络插件。如果您需要使用 Calico 网络插件，请执行：

bash setup.sh --network-mode calico
信息
  • 使用 IPv6 地址访问：在命令中添加 --ip-family ipv6 参数。
  • 同时支持 IPv4 和 IPv6：在命令中添加 --ip-family dual 参数。
警告

确保安装程序所在节点的 IP 地址和 8080 端口可以正常访问，以便安装程序成功启动后能够顺利访问提供的 Web UI。

参数配置

根据页面指引完成安装参数配置后，确认安装。

参数说明 提供了关键参数的详细说明。请仔细阅读并根据实际需求进行配置。

验证安装成功

安装完成后，平台访问地址将显示在页面上。点击 访问 按钮跳转到平台 Web UI。

在 平台管理 视图中，依次点击 集群管理 > 集群，找到名为 global 的集群。

从右侧下拉菜单选择 CLI 工具，执行以下命令以验证安装状态：

# 检查是否有失败的 Charts
kubectl get apprelease --all-namespaces
# 检查是否有失败的 Pods
kubectl get pod --all-namespaces | awk '{if ($4 != "Running" && $4 != "Completed")print}' | awk -F'[/ ]+' '{if ($3 != $4)print}'

参数说明

参数说明
Kubernetes 版本

所有可选版本都经过严格的稳定性和兼容性测试。
建议：选择最新版本以获得最佳功能和支持。

集群网络协议

支持三种模式：IPv4 单栈、IPv6 单栈、IPv4/IPv6 双栈。
注意：如果选择双栈模式，请确保所有节点已正确配置 IPv6 地址；设置后无法更改网络协议。

集群地址

    输入预先准备好的域名。如果没有可用的域名，请输入预先准备好的 global VIP。
    自建 VIP 默认情况下是禁用的，仅在未提供 LoadBalancer 时启用。启用后，安装程序将自动部署 keepalived 以提供软件负载均衡支持。
    注意：使用 自建 VIP 时必须满足以下条件，

    • 有可用的 VRID；
    • 主机网络支持 VRRP 协议；
    • 所有控制平面节点和 VIP 必须位于同一子网内。

    提示：对于功能体验场景的单节点部署，您可以直接输入节点 IP。无须启用 自建 VIP 或准备 global VIP 等网络资源。

平台访问地址

    如果您不需要区分 集群地址 和 平台访问地址，请输入与 集群地址 相同的地址。
    如果需要区分，例如，global 集群仅供内部网络访问，而平台需要提供外部网络访问，请输入预先准备好的域名或 外部 IP。
    平台默认使用 HTTPS 访问，不启用 HTTP。如果需要启用 HTTP 访问，请在 高级设置 中启用（不建议）。
    注意：在以下情况下必须输入域名，

    • 如果规划了 global 集群的灾备方案；
    • 如果平台需要支持 IPv6 访问。

    提示：如果需要配置更多平台访问地址，可以在下一步的 其他设置 > 其他平台访问地址 中添加。或者，在安装后根据用户手册在平台管理中添加。

证书

平台提供自签名证书，默认支持 HTTPS 访问。
如果需要使用自定义证书，可以上传现有证书。

镜像仓库

默认情况下，使用 平台部署 镜像仓库，其中包含所有组件的镜像。
如果需要使用 外部 镜像仓库，请联系技术支持以获取镜像同步方案后再进行配置。

容器网络

集群的默认子网和服务网络段不能重叠。
使用 Kube-OVN Overlay 网络时，确保容器网络与主机网络不在同一网络段，否则可能会导致网络异常。

节点名称

如果选择 主机名作为节点名称，请确保所有节点的主机名唯一。

global 集群平台节点隔离

仅在规划在 global 集群中运行应用工作负载时启用。
启用后：

  • 可以将节点设置为 平台独占，即仅运行平台组件，从而确保平台和应用工作负载隔离；
  • 排除 DaemonSet 类型的工作负载。
添加节点控制平面节点：
    • 支持添加 1 或 3 个控制平面节点（3 个用于高可用性配置）；
    • 如果启用 平台独占，则强制禁用 可部署应用，控制平面节点仅运行平台组件；
    • 如果禁用 平台独占，可以选择是否启用 可部署应用，允许控制平面节点运行应用工作负载。
工作节点：
    • 如果启用 平台独占，则强制禁用 可部署应用；
    • 如果禁用 平台独占，则强制启用 可部署应用。

使用 Kube-OVN 时，您可以通过输入网关名称来指定节点网络卡。

如果节点可用性检查失败，请根据页面提示进行调整，并重新添加。

安装程序清理

安装后，安装程序通常会自动删除。如果安装后 30 分钟内安装程序未自动删除，请在安装程序所在节点上执行以下命令以强制删除安装程序容器：

docker rm -f minialauda-control-plane
本页概览