安装及验证

更新时间：2025-01-02 GMT+08:00

查看PDF

在UCS控制台成功添加集群后，集群状态将会显示为“等待安装并接入”，此时UCS并没有为集群安装Kubernetes软件以及打通与集群的网络连接，因此需要在集群中配置网络代理来接入网络并完成集群安装。

须知：

请在添加集群后的24小时内接入网络，您可单击右上角按钮查看详细的网络接入流程。如您未在24小时内接入网络，将会导致集群接入失败，可单击右上角按钮重新接入集群。如果已经接入但状态未更新，请等待2分钟后刷新集群。

登录UCS控制台，单击待接入集群栏的“点击接入”进入集群接入界面，可选择“公网接入”和“私网接入”。
选择接入方式并下载代理配置文件。

若选择“公网接入”，直接在界面单击“下载文件”，下载本地集群代理配置文件“agent-[集群名称].yaml”。

若选择“私网接入”，需要先选择项目，再选择安装前准备（私网接入）中创建的终端节点，然后单击“下载文件”，下载本地集群代理配置文件“agent-[集群名称].yaml”。
说明：

集群代理配置文件存在私有密钥信息，每个集群仅能下载一次，请您妥善保管。
输入集群安装所需参数并下载集群配置文件“cluster-[集群名称].yaml”。

若集群为1.28.5及之后版本，此处可选择“集群架构”X86 或者 ARM类型。

图1 下载集群配置文件
通过远程传输工具，使用root用户将下载的“agent-[集群名称].yaml”和“cluster-{集群名称}.yaml”文件上传到执行机的“/root/”目录下。
说明：
- 执行机如果出现SSH连接超时，请参考虚拟机SSH连接超时处理方法处理。
- 选择集群架构后，请确认ucs-ctl的执行机与集群架构一致。

ucs-ctl是管理UCS本地集群的命令行工具，在安装本地集群并使用ucs-ctl工具前，为防止您执行被篡改的ucs-ctl工具，请先进行工具的完整性校验。ucs-ctl的详细介绍请参见使用ucs-ctl命令行工具管理本地集群。

本地集群支持使用sha256校验文件来验证 ucsctl 文件的完整性。

单击“安装集群”，复制如图2所示位置的地址并记录，即ucs-ctl工具的安装地址。

图2 ucs-ctl下载地址
将如下命令中的下载地址替换为1中所记录的地址，然后执行命令，以下载sha256 校验文件。
```
curl 下载地址.sha256 -o ucs-ctl.sha256 # 
```
将该校验文件移动至ucs-ctl 同目录下，执行如下命令，以校验工具的完整性。
```
sha256sum -c <(grep ucs-ctl ucs-ctl.sha256)
```
执行命令后输出为 “OK”，则校验通过；若输出为“FAILED”，则校验错误，请提交工单，联系技术支持人员解决。

父主题： 安装本地集群

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消