安装脚本配置说明

使用场景

• 使用系统镜像创建集群后，需要在创建集群后安装自定义软件或配置软件环境。

• 使用自定义镜像创建集群，需要在创建集群后执行自定义脚本配置软件环境。

配置说明

创建集群时，在软件配置的高级配置中设置安装脚本。安装脚本支持包含bash、python等可以在Linux Shell环境中运行的脚本类型，脚本第一行必须加上注解指明运行时调用的命令，例如bash脚本第一行为#!/bin/bash。

脚本示例

该脚本示例输出集群环境变量、集群元数据、节点角色到/root目录下对应的log文件中。具体脚本示例下载地址，请参见下载地址。

#!/bin/bash

echo "call $0 with param: $@" | tee /root/command.log


## show all available environment variables
printenv | tee /root/env.log

## Cluster meta data
echo "ClusterId: ${ClusterId}, HOSTNAME: ${HOSTNAME}" | tee /root/cluster.log
echo "AccountType: ${AccountType}, SchedulerType: ${SchedulerType}" | tee -a /root/cluster.log

## Role of current machine
echo "${Role}" | tee /root/role.log

if [ "${isLoginNode}" == "true" ]; then
  ## Do your work on login node
  echo "This is login node" | tee -a /root/role.log
  exit $?
fi

if [ "${isAccountManager}" == "true" ]; then
  ## Do your work on NIS/LDAP master
  echo "This is account manager" | tee -a /root/role.log
  exit $?
fi

if [ "${isResourceManager}" == "true" ]; then
  ## Do your work on Slurm/PBS master
  echo "This is scheduler" | tee -a /root/role.log
  exit $?
fi

if [ "${isComputeNode}" == "true" ]; then
  ## Do your work with on compute node
  echo "This is compute node" | tee -a /root/role.log
  exit $?
fi

环境变量

自定义安装脚本默认在集群的所有节点上执行，您可以通过设置环境变量指定在不同类型节点上执行的操作。可用环境变量说明如下：

异常处理

创建集群时可能会出现异常，常见异常说明如下：

• 如果集群创建过程中出现异常，导致集群创建失败，则不会执行安装脚本。

• 如果集群创建成功，但是单个计算节点异常，则该异常节点上不会执行安装脚本。

• 如果集群创建成功，通过脚本的返回值判断执行结果，返回值约定同Shell，非0代表失败。如果失败，您可以在操作日志查看告警，详细错误信息请登录集群，在执行失败的节点/root目录下查询日志文件。