配置命令行工具

操作步骤

1. 下载命令行工具。
2. 安装命令行工具。
   本示例中以Windows系统为例，介绍安装命令行工具的方法。

   1. 下载Windows版本的客户端，得到health.exe文件，health文件无需安装，放置在任一文件夹中即可。
      图1 下载命令行工具
      
   2. 使用win键+R，输入cmd打开windows的cmd窗口。进入工具所在的目录，输入health命令，即可使用。
      如果cmd窗口显示目录不是health文件所在目录，请使用cd命令切换路径。例如，切换至D盘：

      cd /d d:

      

      使用Linux版本命令行工具时，您需要在本地搭建Linux环境，并将下载的health文件放至所需的目录下。

      • 如果当前目录为health所在目录，可以使用./health命令使用命令行工具。
      • 如果当前目录不是health所在目录，需要使用绝对路径。如当前目录为/opt，假设health存放在/root/health-toolkit/下，需要指定/root/health-toolkit/health路径进行使用。
      • 如果无法运行，提示Permission denied，请使用chmod 755 health命令设置执行权限。

3. 初始化配置。

   在使用命令行工具前，需要初始化配置信息。执行health config add命令配置AK/SK，区域名称，华为云项目ID信息，获取方法请参见获取认证信息。

   • 命令结构

     health config add [flags]

     表1 参数说明

     参数	简写	是否必选	说明
     --ak	-a	是	AK(Access Key ID)：访问密钥ID。
     --sk	-s	是	SK(Secret Access Key)：与访问密钥ID结合使用的密钥。
     --region	-r	是	服务区域名称。
     --platform-id	-i	是	华为云项目ID，请按获取认证信息中的方法获取。
     --log-path	-l	否	日志路径，不填写时默认为命令行工具当前路径下healthcli.log文件。
     --http-proxy	-p	否	HTTP代理配置，格式为“http://username:password@your-proxy:your-port”。
     --swr-endpoint	-t	是	SWR镜像仓库地址。 获取方式： 登录容器镜像服务管理控制台。 单击界面右侧“登录指令”，获取内网登录指令末尾的SWR镜像仓库地址。例如100.78.15.50:20202。
     --iam-endpoint	-m	是	IAM终端节点名称，请在地区与终端节点中获取。
     --health-endpoint	-e	是	EIHealth终端节点名称，请在地区与终端节点中获取。
     --obs-endpoint	-o	是	OBS终端节点名称，请在地区与终端节点中获取。
     --obs-install-path	-q	否	设置obsutil安装路径，默认安装在当前运行目录。 设置时，该路径必须为obsutil运行文件名，如/home/path/obsutil、/home/path/obsutil-1.1.1
     --obs_down_load_url	-D	否	obsutil下载链接，obsutil将下载到obs-install-path上。 参数有改动时才会触发下载。 下载链接的内容可以是zip、tar.gz文件、二进制文件，如果是压缩文件，文件夹内的obsutil必须命名为obsutil（和obsutil官方链接保持一致）。
     --force	-f	否	强制操作。如果下载obsutil时，指定的obs-install-path上已经有同名文件，不带-f时会提示用户，带上-f会直接覆盖原文件。

   • 命令示例

     health config add --ak CAIxxxxxxxxxFE --sk QLFxxxxxxxxxxxxtNvsF --region cn-north-4 --platform-id catdi9fb689  --swr-endpoint 100.78.15.50:20202  --iam-endpoint iam.cn-north-4.myhuaweicloud.com --health-endpoint eihealth.cn-north-4.myhuaweicloud.com --obs-endpoint obs.cn-north-4.myhuaweicloud.com
     # 执行成功返回结果如下
     add ak successfully! 
     add sk successfully! 
     add region successfully!
     add platform-id successfully!
     add swr-endpoint successfully!
     add iam-endpoint successfully!
     add health-endpoint successfully!
     add obs-endpoint successfully!

     

     • 执行以上命令，会在系统所在的用户目录下自动生成“.health”文件夹，文件夹中包含config.ini配置文件，用于存储任务执行所涉及到的配置，如密钥、区域、当前项目等信息。
     • 生成的配置文件不建议直接修改，如需改动请使用命令行工具修改。
     • 配置文件中保存有用户的AK、SK信息，为了避免密钥泄露，会对文件中的SK进行加密以保护密钥安全。