云助手客户端是为ECS实例执行云助手命令的代理程序。本文介绍如何安装云助手客户端。

前提条件

使用自定义镜像或者云市场镜像创建的ECS实例,请先查询您的实例规格以及操作系统是否能使用云助手服务,再自行安装客户端。详情请参见云助手概述的使用限制章节。

背景信息

2017年12月01日之后使用公共镜像创建的ECS实例,默认预装云助手客户端。如果您的实例是2017年12月01日之前购买的,若需要使用云助手相关功能,请自行安装云助手客户端。

通过下载链接安装客户端(Windows实例)

完成以下操作,通过下载链接安装Windows实例云助手客户端:

  1. 远程连接Windows实例。具体操作,请参见远程连接Windows实例
  2. 下载云助手客户端。具体操作,请参见下载云助手客户端
  3. 双击客户端文件,根据安装向导完成安装。
    说明 如果您选择默认安装路径,则客户端在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\
  4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区

通过下载链接安装客户端(Linux实例)

Linux实例需要根据您的操作系统,选择下列安装方式的其中一种:
  • RPM包安装,适合CentOS、RHEL和SUSE Linux等操作系统:
    1. 远程连接Linux实例。具体步骤,请参见远程连接Linux实例
    2. 运行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm下载云助手客户端rpm包。
    3. 运行rpm -ivh aliyun_assist.rpm安装云助手客户端。
    4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
  • deb包安装,适合Debian和Ubuntu等操作系统:
    1. 远程连接Linux实例。
    2. 运行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.deb下载云助手客户端deb包。
    3. 运行dpkg -i aliyun_assist.deb安装云助手客户端。
    4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
  • 源码编译安装:
    1. 远程连接Linux实例。
    2. 运行git clone https://github.com/aliyun/aliyun_assist_client下载云助手客户端源码。
    3. 进入源码存放目录。
    4. 运行cmake .生成编译文件。
      说明 若编译时报错CMAKE_MINIMUM_REQUIRED,请前往CMake官网升级CMake服务至3.1及以上版本。
    5. 运行make开始编译。
    6. 运行./cmake_install.sh安装云助手客户端。
    7. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
说明 如果您选择默认安装路径,则客户端在Linux实例中的安装目录为:
  • CoreOS操作系统:/opt/local/share/aliyun-assist/
  • 其他操作系统(Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、OpenSUSE和Aliyun Linux等):/usr/local/share/aliyun-assist/

通过阿里云CLI安装客户端(Windows或Linux实例)

前提条件:
  • 本示例在命令行工具中完成,请确保您已经安装了阿里云命令行工具CLI。如何获取和安装阿里云CLI,请参见安装阿里云CLI
  • 已获取地域ID,示例命令中需要填写。详细的地域ID,请参见地域和可用区

完成以下操作,通过阿里云CLI安装客户端:

  1. 调用DescribeCloudAssistantStatus查询目标ECS实例是否安装了云助手客户端。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp --output cols=CloudAssistantStatus
    当返回CloudAssistantStatus=true结果时,表示您的ECS实例已安装云助手客户端。否则请继续进入下一步。
  2. 调用InstallCloudAssistant为ECS实例安装云助手客户端。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp
  3. 调用RebootInstance重启目标ECS实例。
    aliyun ecs RebootInstance --RegionId TheRegionId --InstanceId i-bp1g6zv0ce8ogXXXXXXp
  4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区