安装参考
本页面介绍每个 provider 共有的内容:安装目录、通用 install-config.yaml 字段,以及 manifests、create 和 destroy 命令。每个 provider 的安装和参数页面都会链接到此处。
安装目录
在本文档中,<install-dir> 是安装目录:bootstrap 节点上用于存放一个 global 安装的目录。您可以选择其路径,并使用 --dir <install-dir> 将其传递给 ac。
- 在运行
ac之前,创建该目录并在其中写入install-config.yaml。ac不会创建这两者。如果缺少其中任意一个,ac将停止并报错。 - 每个
global安装使用单独的目录。在灾难恢复对中,两端各自在自己的 bootstrap 节点上拥有自己的目录。 - 对该安装的每个
ac命令使用同一个目录,包括再次运行create时。
您需要写入 install-config.yaml。ac 会将其他所有内容写入该目录。
- 保持文件私有(
chmod 600 <install-dir>/install-config.yaml),因为其中包含密码。 - 不要编辑
manifests/中的文件。 - 安装完成后保留该目录。
output/kubeconfig和logs/仅存在于该目录中。
通用 install-config.yaml 字段
该文件包含四个部分:
global:registry 和平台身份。cluster:网络、密钥和加密。provider.<name>:一个 provider 的基础设施。- 节点组
controlPlane和computes。
以下结构展示了每个 provider 使用的字段。这不是完整文件。请改为复制您的 provider 的模板。该模板会添加并描述该 provider 的字段,例如控制平面 endpoint、节点网络和节点磁盘。如果字段未知或拼写错误,ac 会在进行任何更改之前失败,并在错误中指出字段路径。
computes 是可选的。没有它时,平台仅运行在控制平面节点上。
平台节点组
deployMode: base 会为节点组添加标签和污点,使其仅运行平台。如果任何节点组使用 base,则整个平台会以 base 模式安装。此时,base 组总共必须至少有一个副本。
渲染的清单
要渲染集群对象而不应用任何对象,请在 bootstrap 节点上运行以下命令:
此步骤是可选的,因为 create 会以相同方式渲染对象。manifests 会运行不需要 bootstrap 集群的检查,并将对象写入 <install-dir>/manifests/。create 会运行其余检查。
当 manifests/ 已存在时,manifests 和 create 会询问是否重用它。按 Enter 键即可重用。更改 install-config.yaml 后,回答 n 以再次渲染清单。当标准输入不是终端时,请传递 --reuse-manifests=true 或 --reuse-manifests=false。
- 重用会按磁盘上的原样应用文件,而不进行检查。更改后的基础设施凭证、加密密钥或 Bare Metal ServiceAccount 签名密钥不会生效。
- 再次渲染会替换整个
manifests/目录。已应用的 Secret 不会发生更改。更改后的基础设施凭证或加密密钥仍不会生效。更改后的 Bare Metal ServiceAccount 签名密钥会使create因错误而停止。
create 命令
在 bootstrap 节点上运行 create:
create 不接受 --kubeconfig。
如果 create 因中断、错误或某个阶段超出 --timeout 而停止,请再次运行相同的命令。已完成的工作会被跳过。
- 每个错误都会打印用于恢复安装的命令。将其中开头的
ac替换为<extract-dir>/res/<arch>/ac。 - 镜像仓库检查失败时,错误还会打印一个带有
--reuse-manifests=false的变体。更正global.registry后运行该变体。 - bootstrap 集群启动后,请勿更改
global.registry;请参阅故障排除。
当 create 无错误返回时,安装即完成,并且 bootstrap 集群会被移除。关于需要保留的内容,请参阅安装目录。create 仅安装集群。要更改正在运行的集群,请参阅管理 Alauda OS 集群上的节点。
在 global 集群上,请勿删除 Cluster API Cluster global、其 KubeadmControlPlane 或 provider 的基础设施对象。删除这些对象会销毁集群的机器。要移除集群,请使用 destroy。
destroy 命令
在能够通过 kubeconfig 访问 global 集群的计算机上运行 destroy,例如 <install-dir>/output/kubeconfig。在 bootstrap 节点上,以 <extract-dir>/res/<arch>/ac 身份运行 ac。
命令会删除和保留的内容取决于 provider;请参阅 provider 的“删除 global Cluster”页面。该命令不支持裸金属。以下内容适用于每个 provider:
- 当目标不是使用
ac安装的global集群时,destroy会拒绝运行。如果平台仍管理任何其他集群(包括导入的集群和仅部分创建的集群),它也会拒绝运行。错误信息会列出这些集群。你无法跳过这两项检查。 - 如果运行失败,或控制平面关闭后运行停止,请在同一台计算机上、以同一用户身份并使用同一 kubeconfig 再次运行相同的命令。
destroy会从你确认删除时保存的计划继续执行。该计划包含基础设施凭证。 - 如果集群有响应,但使用
401、403或不受信任的证书拒绝 kubeconfig,destroy会停止运行且不会删除任何内容。该地址现在可能属于另一个集群。 - 如果运行结束后仍有任何内容残留,错误信息会列出已保存的计划文件。完成清理后删除该文件。
- 如果集群始终没有响应,则无法使用
ac销毁它。请在基础设施侧清理此次失败的安装。 destroy会保留 bootstrap 节点的现状。ac adm alpha cluster destroy --cluster global会被拒绝。该命令用于工作负载集群。