配置云助手客户端

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

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

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仓库参与开源计划。

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

• 云助手
• InvokeCommand
• 云助手自动化部署实践