安装MindCluster集群调度前配置

使用约束

• 集群已完成Kubernetes的安装部署，且使用kubectl get pod -A -owide命令查询节点状态为Running正常。
• 使用MindCluster Ascend Deployer安装MindCluster集群调度时，建议选择worker节点作为执行机。
• 安装MindCluster集群调度单个组件时，优先安装Ascend Docker Runtime、Volcano。
• 如需使用MindCluster集群调度，请参见《MindCluster 集群调度用户指南》的“使用”>“基础调度”章节。

前提条件

• 已完成参数面网络配置。执行集群训练前，训练节点须进行hccn_tool网络配置，参考步骤 1仅修改配置hccn变量区域。
• 请确保集群所有服务器已配置DNS，所有待安装设备DNS建议保持一致。若未配置DNS，请参考配置DNS完成DNS的配置。

配置inventory_file文件

1. 登录MindCluster Ascend Deployer执行机。
2. 在MindCluster Ascend Deployer执行机上配置待安装设备的IP地址、用户名。

   进入ascend-deployer/ascend_deployer目录，编辑inventory_file文件，添加完成后执行:wq保存退出。

   1. 按照表1，完成master、worker、other_build_image（可选）的变量配置。
      

      如果k8s集群中存在与master节点架构不一致的服务器，并且该节点（或多个异构节点）会部署MindCluster 集群调度时，需在inventory_file文件中配置other_build_image。详细配置方法请参见配置other_build_image。

      表1 参数说明

      参数	是否可选	说明
      IP	必选	服务器的IP地址。
      ansible_ssh_user	必选	ssh登录远程服务器的账号，需要为root账号。
      ansible_ssh_pass	可选	ssh登录远程服务器账号的密码。 如果配置了SSH密钥认证方式且root用户可以登录，则无需配置。
      ansible_ssh_port	可选	ssh连接的端口. 使用默认值22端口时无需配置. 如果使用了非默认的其他端口，则需要配置。
      set_hostname	可选。 多master或多worker节点时必选。 单节点时可选。	设置节点在K8s集群中的节点名，建议用“master-1”或“worker-1”的格式，按照顺序填充。 如果已有K8s集群，则该名字需要为节点在K8s中的名字，必须配置为小写，不可随意填写。
      npu_num	可选。 安装MindIO时必选。	设置NPU卡的数量。
      说明 配置master节点的主机为K8s的默认控制节点。 master个数必须为奇数。

   2. 在[all:vars]配置字段下完成全局变量配置。

      表2 参数说明

      参数	是否可选	说明
      SCALE	可选	用于决定是否进行分批部署的可选参数。 默认值为false。 当K8S集群规模比较大的时候，可进行分批部署。第二批及之后场景需设置此参数值为true。
      RUNNER_IP	可选	可配置为MindCluster Ascend Deployer执行机的IP地址，请注意该IP需与其他待安装设备互通。 建议在执行机含有多网段多个本机IP时配置该字段。

3. （可选，安装MindIO时必选）若有定制化安装MindIO需求，进入ascend_deployer/templates/mindio目录，编辑memfs.conf文件，添加完成后执行:wq保存退出。
   memfs.conf文件的填写说明请参见《MindCluster MindIO ACP用户指南》的“安装部署>安装 MindIO >在计算节点安装 MindIO 服务”章节。

   

   Atlas A2 训练系列产品上，IP支持配置IPv4和IPv6两种类型的IP地址，用户使用PuTTY等SSH客户端连接执行机的IP地址和inventory_file文件中配置的IP地址类型需要保持统一，均为IPv4或IPv6。其他设备仅支持配置为IPv4地址。