安装云助手客户端

Windows实例安装客户端

1. 以管理员权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 下载云助手客户端。
   云助手客户端下载地址：

   • 公网地址（最新版本）：云助手客户端最新版本。
   • 公网地址（指定版本）：

     https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe

   • 内网地址（最新版本）：

     https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe

   • 内网地址（指定版本）：

     https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网下载1.0.0.128版本，则对应地址如下所示。

   https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_1.0.0.128_setup.exe

3. 双击客户端文件，根据安装向导完成安装。
   如果您选择默认安装路径，客户端在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\。
4. 如果ECS实例的网络类型为经典网络，需要执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
   说明 Windows系统会隐藏已知文件类型的扩展名，您必须设置显示已知文件类型的扩展名才能真正判断region-id是否带有扩展名。

Linux实例安装客户端（rpm包管理方式）

适合Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等操作系统。

1. 以root权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 下载云助手客户端rpm包。
   • 公网地址（最新版本）：

     wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"

   • 公网地址（指定版本）：

     wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

   • 内网地址（最新版本）：

     wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"

   • 内网地址（指定版本）：

     wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网下载1.0.2.458版本，则对应地址如下所示。

   wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"

3. 安装云助手客户端。
   此示例表示安装最新版本云助手客户端。

   rpm -ivh --force aliyun_assist_latest.rpm

4. 如果ECS实例的操作系统为RedHat，需要执行以下操作。
   1. 关闭qemu-ga服务。

      systemctl stop qemu-guest-agent
      systemctl disable qemu-guest-agent

   2. 重启云助手服务。

      systemctl restart aliyun.service

5. 如果ECS实例的网络类型为经典网络，需要执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。

Linux实例安装客户端（deb包管理方式）

适合Debian和Ubuntu等操作系统。

1. 以root权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 下载云助手客户端deb包。
   • 公网地址（最新版本）：

     wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"

   • 公网地址（指定版本）：

     wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.deb"

   • 内网地址（最新版本）：

     wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.deb"

   • 内网地址（指定版本）：

     wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.deb"

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网下载1.0.2.458版本，则对应地址如下所示。

   wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.deb"

3. 如果ECS实例中已经安装过云助手，卸载旧版本。

   dpkg -r aliyun-assist

4. 安装云助手客户端。
   此示例表示安装最新版本云助手客户端。

   dpkg -i aliyun_assist_latest.deb

5. 如果ECS实例的网络类型为经典网络，需要执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。

Linux实例安装客户端（源代码安装方式）

1. 以root权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 安装git和go等必要的软件。
   此示例通过yum安装，如果您使用其他Linux版本，请修改为对应的包管理工具。

   • 安装git：

     yum install git -y

   • 安装go：

     yum install go -y

3. 下载云助手客户端源码。

   git clone https://github.com/aliyun/aliyun_assist_client

4. 进入源码存放目录。

   cd ./aliyun_assist_client

5. 编译源码。

   go build

   如果返回结果无报错信息，表示安装成功。
6. 如果ECS实例的网络类型为经典网络，需要执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
7. 运行云助手客户端。

   aliyun-service -d

通过阿里云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 --InstanceId i-bp1g6zv0ce8og******p

4. 如果ECS实例的网络类型为经典网络，在实例内部添加所属地域声明。
   1. 以root/system权限远程连接ECS实例。连接方式请参见连接方式概述。
   2. 查看云助手版本。
      • Linux：运行以下命令。

        aliyun-service -v

      • Windows：具体操作，请参见升级或禁止升级云助手客户端。

      如果客户端版本高于1.0.1.400，云助手客户端安装成功；否则，继续下一步操作。

   3. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   4. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
   说明 Windows系统会隐藏已知文件类型的扩展名，您必须设置显示已知文件类型的扩展名才能真正判断region-id是否带有扩展名。