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

前提条件

  • 您必须以管理员身份安装和使用云助手客户端。Linux实例的管理员用户名为root,Windows实例的管理员用户名为administrator。
  • 使用自定义镜像或者云市场镜像创建的ECS实例,请先查询您的实例规格以及操作系统是否能使用云助手服务,再自行安装客户端。详情请参见云助手概述的使用限制章节。

背景信息

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

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

  1. 以管理员权限远程连接ECS实例。连接方式请参见连接方式概述
  2. 下载云助手客户端。下载链接:云助手客户端
  3. 双击客户端文件,根据安装向导完成安装。
    如果您选择默认安装路径,则客户端在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\
  4. 仅限经典网络类型实例:在云助手的安装目录下,创建名为region-id的文件(不要添加类似.txt.conf的扩展名),在region-id文件中填入ECS实例所属地域的ID,例如cn-hangzhou。取值请参见地域和可用区

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

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

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

  1. 调用DescribeCloudAssistantStatus查询目标ECS实例是否安装了云助手客户端。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]
    返回CloudAssistantStatus=true时,表示ECS实例已安装云助手客户端。否则,请继续下一步。
  2. 调用InstallCloudAssistant安装云助手客户端。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p
  3. 调用RebootInstance重启ECS实例。
    aliyun ecs RebootInstance --RegionId TheRegionId --InstanceId i-bp1g6zv0ce8og******p
  4. 仅限经典网络类型ECS实例:在实例内部添加所属地域声明。
    1. 以root/administrator权限远程连接ECS实例。连接方式请参见连接方式概述
    2. 在云助手的安装目录下,创建名为region-id的文件(不要添加类似.txt.conf的扩展名),在region-id文件中填入ECS实例所属地域的ID,例如cn-hangzhou。取值请参见地域和可用区