Ascend Operator

使用整卡调度（训练）、静态vNPU调度（训练）、、断点续训或弹性训练的用户，必须安装MindCluster Ascend Operator或MindCluster HCCL Controller其中一种组件。如果使用MindCluster Volcano组件作为调度器，需要先安装MindCluster Volcano组件，否则MindCluster Ascend Operator会启动失败。
仅使用整卡调度（推理）、静态vNPU调度（推理）、容器化支持、资源监测、推理卡故障恢复或推理卡故障重调度的用户，可以不安装MindCluster Ascend Operator，请直接跳过本章节。

操作步骤

以root用户登录K8s管理节点，并执行以下命令，查看MindCluster Ascend Operator镜像和版本号是否正确。
```
docker images | grep ascend-operator
```
回显示例如下：
```
ascend-operator                      v6.0.RC2              c532e9d0889c        About an hour ago         137MB
```
- 是，执行步骤2。
- 否，请参见准备镜像，完成镜像制作和分发。
将MindCluster Ascend Operator软件包解压目录下的yaml文件，拷贝到K8s管理节点上任意目录。
如不修改组件启动参数，可跳过本步骤。否则，请根据实际情况修改yaml文件中MindCluster Ascend Operator的启动参数。启动参数请参见表1，可执行./ascend-operator -h查看参数说明。

在管理节点的yaml所在路径，执行以下命令，启动MindCluster Ascend Operator。

kubectl apply -f ascend-operator-v{version}.yaml

启动示例如下：

deployment.apps/ascend-operator-manager created
serviceaccount/ascend-operator-manager created
clusterrole.rbac.authorization.k8s.io/ascend-operator-manager-role created
clusterrolebinding.rbac.authorization.k8s.io/ascend-operator-manager-rolebinding created
customresourcedefinition.apiextensions.k8s.io/ascendjobs.mindxdl.gitee.com created
...

执行以下命令，查看组件是否启动成功。

kubectl get pod -n mindx-dl

回显示例如下，出现Running表示组件启动成功。

NAME                                         READY   STATUS    RESTARTS   AGE
...
ascend-operator-7667495b6b-hwmjw   1/1    Running   0          11s

安装组件后，组件的Pod状态不为Running，可参考组件Pod状态不为Running章节进行处理。
安装组件后，组件的Pod状态为ContainerCreating，可参考集群调度组件Pod处于ContainerCreating状态章节进行处理。
启动组件失败，可参考启动集群调度组件失败，日志打印“get sem errno =13”章节信息。
组件启动成功，找不到组件对应的Pod，可参考组件启动yaml执行成功，找不到组件对应的Pod章节信息。

参数说明

表1 MindCluster Ascend Operator启动参数
参数	类型	默认值	说明
-version	bool	false	是否查询MindCluster Ascend Operator二进制版本号。 true：查询。 false：不查询。
-logLevel	int	0	日志级别： -1：debug 0：info 1：warning 2：error 3：critical
-maxAge	int	7	日志备份时间限制，取值范围为7~700，单位为天。
-logFile	string	/var/log/mindx-dl/ascend-operator/ascend-operator.log	日志文件。说明：单个日志文件超过20 MB时会触发自动转储功能，文件大小上限不支持修改。转储后文件的命名格式为：ascend-operator-触发转储的时间.log，如：ascend-operator-2023-10-07T03-38-24.402.log。
-maxBackups	int	30	转储后日志文件保留个数上限，取值范围为1~30，单位为个。
-enableGangScheduling	bool	true	是否启用“gang”策略调度，默认开启。开启时根据任务指定的调度器进行任务调度。“gang”策略调度说明请参见开源Volcano官方文档。 true：启用“gang”策略调度。 false：不启用“gang”策略调度。
-isCompress	bool	false	当日志文件大小达到转储阈值时，是否对日志文件进行压缩转储（该参数后面将会弃用）。 true：压缩转储。 false：不压缩转储。
-kubeconfig	string	无	kubeconfig的路径，当程序运行于集群外时必须配置。
-kubeApiBurst	int	100	与K8s通信时使用的突发流量。取值范围为（0,10000]，不在取值范围内使用默认值100。
-kubeApiQps	float32	50	与K8s通信时使用的QPS（每秒请求率）。取值范围为（0,10000]，不在取值范围内使用默认值50。
-h或者-help	无	无	显示帮助信息。

父主题： 手动安装