Huawei Cloud Stack 业务集群的前提条件
在创建集群之前,请满足以下条件。
提供商
在 global 集群上安装以下集群插件:
- Alauda Container Platform Cluster Bootstrap Provider
- Alauda Container Platform Infrastructure Provider for Huawei Cloud Stack
在 Huawei Cloud Stack 上安装了 ac 的 global 集群已运行这两个插件。否则,请从 ACP Common Aligned Extensions 下载它们(参见下载),使用 violet push 上传它们(参见上架软件包),并按照集群插件中的说明安装。在 Global Cluster Disaster Recovery 对中,请在两个 global 集群上都安装它们。
计算值
在 install-config.yaml 中,使用 HCS API 值而不是租户 UI 中显示的名称来指定节点的镜像、flavor 和可用区。镜像说明如下。有关 flavor 和可用区,请参见HCS 对象、配额和节点地址。有关每个节点组的磁盘,请参见磁盘。
Alauda OS 镜像
将为 global 集群上安装的 ACP 版本发布的 Alauda OS 镜像上传到 HCS;请参见下载 Alauda OS。请记下上传镜像时指定的确切名称,因为集群通过该名称引用镜像。镜像架构必须与 flavor 的架构匹配。镜像必须包含 ac 安装的 Kubernetes 版本;请参见Kubernetes 版本。
镜像 ConfigMap
将镜像上传到 HCS 时,在 global 集群上使用 ConfigMap 注册每个镜像。创建集群时不会读取这些 ConfigMap;平台升级会读取。ACP 无法发现 HCS 项目中的镜像,因此升级只能从这些 ConfigMap 中获取镜像信息。每个镜像创建一个 ConfigMap。它记录:
- 镜像名称
- 制作该镜像所用的 Alauda OS 镜像对应的 ACP 版本
- 该 ACP 版本的 Kubernetes 版本和 etcd 标签
平台升级使用这些 ConfigMap 查找每个 Kubernetes 版本对应的镜像。节点组运行的镜像对应的 ConfigMap 还会告知升级该节点组的架构。因此,每个 HCS 集群都需要这些 ConfigMap,包括使用 YAML 创建的集群。在升级前,还要按照准备 Alauda OS 镜像中的说明,注册升级路径上每个版本的镜像。此外:
- 保留早期 ACP 版本的 ConfigMap。
- 对于每个 ACP 版本,每种架构只注册一个镜像。
cpaas.io/hcs-vm-template标签值必须与 HCS 中的镜像名称匹配。
在生成器中,选择所有已注册镜像对应的架构。每个生成的 ConfigMap 都会记录其架构。先运行 ac config use-cluster global,然后运行生成器输出的命令。
Run the command on the global cluster. In a DR environment, run it on both global clusters: the ConfigMaps are not synchronized between them.
For each ACP version, register images of only one OS per architecture on a global cluster. When images of different OSes have the same Kubernetes version and architecture, an upgrade can move a cluster to the other OS.
ConfigMaps created from earlier versions of this document have no architecture key and no architecture in their name. Once the ConfigMaps of an ACP version exist for each architecture that you use, you can delete the earlier ConfigMaps of that version when no upgrade is in progress.
对于每个 Kubernetes 版本,注册集群所使用的每种架构对应的镜像。在混合使用 x86_64 和 aarch64 节点池的集群中,每个镜像 ConfigMap 都必须设置 architecture。
检查镜像对应的 ConfigMap 是否存在。在已登录平台的 ac 所在的机器上运行以下命令:
如果没有 ConfigMap 列出你的镜像名称,请创建该镜像对应的 ConfigMap。
网络连接
允许来自 global 集群节点以及运行 ac 的机器的流量访问 HCS 服务和 IAM 端点。端点列于 Huawei Cloud Stack。此外,还需允许 global 集群节点访问控制平面 VIP,相关信息见 Workload Cluster VIP and Nodes。
控制平面 ELB 地址
在 ELB 子网中,为 VIP 预留一个空闲 IPv4 地址,并为每个 L4 和 L7 Hybrid Load Balancing 组各预留恰好两个空闲 IPv4 地址。请参阅控制平面端点。
镜像仓库
集群从 global 集群的仓库或专用仓库拉取平台组件。请在创建集群之前选择仓库;请参阅为业务集群选择镜像仓库。
HCS 凭证 Secret
global 集群的 cpaas-system 中必须存在 HCS 凭证 Secret。请注意 Secret 的使用方式:
- 集群通过名称引用 Secret。与
global集群不同,它不会包含内联凭证。 ac从不创建或删除 Secret。- 一个 Secret 可以供多个集群使用,其名称无需与集群名称匹配。
- 在引用该 Secret 的所有集群都删除之前,请保留此 Secret。
请在编辑器中编写凭证文件,而不是在 shell 提示符下编写,因为 shell 会将密钥记录在历史记录中:
每行按 key=value 的格式编写,不要加引号,因为 ac 会将引号字符作为值的一部分保留。值中可以包含 =。每行中只有第一个 = 用于分隔键和值。创建 Secret 后,删除该文件:
请勿使用 ac apply 创建或更新 Secret,因为它会将密钥存储在 Secret 的 kubectl.kubernetes.io/last-applied-configuration 注解中。之后如需更改某个值,请将新值写入文件中的 stringData,然后运行 ac patch secret <credential-secret-name> -n cpaas-system --type=merge --patch-file=<file>。
HCS 对象、配额和节点地址
HCS 中必须已存在以下对象。install-config.yaml 使用它们的 HCS API 值来指定对象。ac 不会创建这些对象,名称错误会导致集群创建失败;请参阅故障排除。
- 控制平面和每个工作节点组的 ECS 规格。请使用每个规格的 API 名称,而不是租户 UI 中显示的名称。规格决定 CPU 和内存。
- 可用区(如果指定)。请使用可用区的 API 名称,而不是显示名称。请参阅可用区放置。
- VPC、安全组以及
install-config.yaml指定的所有子网。这些子网包括节点子网,以及 ELB、附加 NIC 或节点组所需的任何子网。它们属于该 VPC,并允许集群节点相互通信。安全组需允许通信矩阵中列出的节点间端口,以及Huawei Cloud Stack中列出的从 ELB 到控制平面节点的流量。 - EVS 磁盘类型,系统盘和数据盘的类型名称为
SSD、SAS或SATA。该类型必须在目标可用区中可用。 - 实例、EVS 磁盘、ELB 和服务器组的配额。创建集群前请确认配额。
每个节点都需要在其子网中拥有一个未分配的静态 IPv4 地址,每个附加 NIC 还需额外分配一个地址,并且需要一个主机名。HCS 节点仅使用静态地址。请向 HCS 管理员获取准确的规格和可用区值,因为 HCS 租户控制台可能不会显示这些值。
节点标签和污点
若要将节点池专用于监控、日志记录或入口流量等用途,请按照基础设施节点中的说明规划其角色标签和污点。install-config.yaml 不会设置这些标签和污点。