云助手客户端是为ECS实例执行云助手命令的代理程序。本文提供安装、升级以及禁用云助手客户端的操作指示。

安装客户端:通过下载链接安装

说明
  • 2017年12月01日之后使用公共镜像创建的ECS实例,默认预装云助手客户端。如果您的实例是2017年12月01日之前购买的,若需要使用云助手相关功能,请自行安装客户端。
  • 使用自定义镜像或者云市场镜像创建的实例,请参见云助手查询您的实例规格以及操作系统是否能使用云助手服务,再自行安装客户端。

Windows实例

  1. 远程连接Windows实例
  2. 下载云助手客户端
  3. 双击客户端文件,根据安装向导安装。

Linux实例

请根据您的操作系统,选择下列安装方式的其中一种。

  • RPM包安装,适合CentOS、RHEL和SUSE Linux等操作系统:

    1. 远程连接Linux实例
    2. 运行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm下载云助手客户端RPM包。
    3. 运行rpm -ivh aliyun_assist.rpm安装云助手客户端。
  • 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安装云助手客户端。
  • 源码编译安装:

    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安装云助手客户端。

安装客户端:通过阿里云CLI安装

前提条件

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

操作步骤

  1. 调用DescribeCloudAssistantStatus查询目标实例是否安装了云助手客户端。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp --output cols=CloudAssistantStatus
    当返回CloudAssistantStatus=true结果时,表示您的实例已安装云助手客户端。否则请继续进入下一步。
  2. 调用InstallCloudAssistant为实例安装客户端。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp

升级客户端

云助手客户端每隔一个小时会运行升级资源检测进程,该进程程序所在路径为:

  • Windows实例:C:\ProgramData\aliyun\assist\${version}/aliyun_assist_update
  • Linux实例:/usr/local/share/aliyun-assist/${version}/aliyun_assist_update
自动升级失效时,您可以创建升级命令CreateCommand),定期执行。以RPM安装包为例,以下云助手命令可以升级云助手客户端:
wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm
rpm -U aliyun_assist.rpm

禁止升级客户端

云助手客户端升级进程默认自启动,您也可以禁用该服务:

  • Windows实例:在命令提示符窗口CMD中运行rename aliyun_assist_update
  • Linux实例:运行chmod a-x aliyun_assist_update

禁用客户端

Windows实例

  1. 远程连接Windows实例
  2. 找到计算机管理 > 服务和应用程序 > 服务,并找到AliyunService
    警告 AliyunService是云助手服务的运行名称,禁用 AliyunService相当于禁用云助手客户端,这可能会导致实例异常并无法在ECS管理控制台停止运行中的实例。建议您谨慎禁用云助手客户端。
  3. 单击停止此服务

Linux实例

  1. 远程连接Linux实例
  2. 根据您的init系统选择以下命令关闭云助手客户端服务。
    • Debian、CentOS和Red Hat等操作系统:
      systemctl stop agentwatch
      
    • 使用其他init系统的操作系统:
      chkconfig agentwatch off

相关链接

云助手客户端代码完全开源,您可以访问阿里云Github仓库参与开源计划。

以下帮助文档中,可能需要使用云助手客户端: