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

前提条件

查询您的实例规格以及操作系统是否能使用云助手后,再自行安装客户端。更多详情,请参见使用限制章节。

背景信息

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

不同操作系统可选择的安装方式如下表所示。

实例操作系统 选择安装方式
Windows
Linux(Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等)
Linux(Debian和Ubuntu等)
Linux(其他)

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的扩展名)。
      重要 Windows系统会隐藏已知文件类型的扩展名,您必须设置显示已知文件类型的扩展名才能真正判断 region-id是否带有扩展名。
    2. region-id文件中填入ECS实例所属地域的ID,例如cn-hangzhou
    以Windows Server 2012 R2为例,在云助手默认安装路径 C:\ProgramData\aliyun\assist\下新建的 region-id文件及填入 cn-hangzhou地域ID的示例结果如下: 在Windows上添加文件

Linux实例安装客户端(rpm包管理方式)

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

  1. 以root权限远程连接ECS实例。
    具体操作,请参见 连接方式概述
  2. 下载云助手客户端rpm包。
    • 公网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"
    • 公网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"
    • 内网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"
    • 内网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"
    说明
    • {version}为云助手客户端的具体版本号。
    • {regionId}为您实例所在的地域的Region ID
    例如在杭州内网地址下载1.0.2.458 x86版本,则对应地址如下所示。
    wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"
  3. 安装云助手客户端。
    如果您选择默认安装路径,则客户端在Linux实例中的安装目录为:
    • CoreOS操作系统:/opt/local/share/aliyun-assist/
    • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):/usr/local/share/aliyun-assist/
    此示例表示安装最新版本云助手客户端。
    • x86版本
      rpm -ivh --force aliyun_assist_latest.rpm
    • arm版本
      rpm -ivh --force aliyun-assist-latest-1.aarch64.rpm
  4. 根据ECS实例的操作系统或网络类型不同,判断是否需要执行以下不同操作。
    • 如果ECS实例的操作系统为RedHat,执行以下操作。
      1. 关闭qemu-ga服务。
        systemctl stop qemu-guest-agent
        systemctl disable qemu-guest-agent
      2. 重启云助手服务。
        systemctl restart aliyun.service
    • 如果ECS实例的网络类型为经典网络,执行以下操作。
      在云助手的安装目录下,创建名为 region-id的文件,并在 region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例,创建 region-id文件并添加 cn-hangzhou地域ID的命令如下:
      • CoreOS操作系统:
        echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id
      • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):
        echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id
      以其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)为例,回显如下: 创建文件

Linux实例安装客户端(deb包管理方式)

适合Debian和Ubuntu等操作系统。

  1. 以root权限远程连接ECS实例。
    具体操作,请参见 连接方式概述
  2. 下载云助手客户端deb包。
    • 公网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"
    • 公网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.deb"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"
    • 内网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.deb"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"
    • 内网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.deb"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"
    说明
    • {version}为云助手客户端的具体版本号。
    • {regionId}为您实例所在的地域的Region ID
    例如在杭州内网地址下载1.0.2.458 x86版本,则对应地址如下所示。
    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. 安装云助手客户端。
    如果您选择默认安装路径,则客户端在Linux实例中的安装目录为:
    • CoreOS操作系统:/opt/local/share/aliyun-assist/
    • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):/usr/local/share/aliyun-assist/
    此示例表示安装最新版本云助手客户端。
    • x86版本
      dpkg -i aliyun_assist_latest.deb
    • arm版本
      dpkg -i aliyun-assist_latest-1_arm64.deb
  5. 如果ECS实例的网络类型为经典网络,执行以下操作。
    在云助手的安装目录下,创建名为 region-id的文件,并在 region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例,创建 region-id文件并添加 cn-hangzhou地域ID的命令如下:
    • CoreOS操作系统:
      echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id
    • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):
      echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id
    以其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)为例,回显如下: 创建文件

Linux实例安装客户端(binary安装方式)

适合主流Linux操作系统。

  1. 以root权限远程连接ECS实例。
    具体操作,请参见 连接方式概述
  2. 下载云助手客户端binary包。
    • 公网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest_update.zip"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"
    • 公网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"
      • arm版本
        wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"
    • 内网地址(最新版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest_update.zip"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"
    • 内网地址(指定版本):
      • x86版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"
      • arm版本
        wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"
    说明
    • {version}为云助手客户端的具体版本号。
    • {regionId}为您实例所在的地域的Region ID
    例如在杭州内网地址下载2.2.3.282 x86版本,则对应地址如下所示。
    wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_2.2.3.282_update.zip"
  3. 安装云助手客户端。
    如果您选择默认安装路径,则客户端在Linux实例中的安装目录为:
    • CoreOS操作系统:/opt/local/share/aliyun-assist/
    • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):/usr/local/share/aliyun-assist/

    请将binary包解压到安装目录后并进行安装。下列示例以2.2.3.282 x86版本的云助手客户端为例。

    unzip  -o aliyun_assist_2.2.3.282_update.zip -d /usr/local/share/aliyun-assist/
    chmod a+x /usr/local/share/aliyun-assist/2.2.3.282/update_install
    bash /usr/local/share/aliyun-assist/2.2.3.282/update_install
  4. 根据ECS实例的操作系统或网络类型不同,判断是否需要执行以下不同操作。
    • 如果ECS实例的操作系统为RedHat,执行以下操作。
      1. 关闭qemu-ga服务。
        systemctl stop qemu-guest-agent
        systemctl disable qemu-guest-agent
      2. 重启云助手服务。
        systemctl restart aliyun.service
    • 如果ECS实例的网络类型为经典网络,执行以下操作。
      在云助手的安装目录下,创建名为 region-id的文件,并在 region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例,创建 region-id文件并添加 cn-hangzhou地域ID的命令如下:
      • CoreOS操作系统:
        echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id
      • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):
        echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id
      以其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)为例,回显如下: 创建文件

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实例的网络类型为经典网络,执行以下操作。
    在云助手的安装目录下,创建名为 region-id的文件,并在 region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例,创建 region-id文件并添加 cn-hangzhou地域ID的命令如下:
    • CoreOS操作系统:
      echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id
    • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):
      echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id
    以其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)为例,回显如下: 创建文件
  7. 运行云助手客户端。
    aliyun-service -d

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

通过阿里云CLI安装客户端,可免除远程连接实例的步骤,请确保您已经为ECS实例安装了阿里云CLI,在不同操作系统中安装CLI的方式如下:
说明 RHEL不支持通过阿里云CLI安装。
  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. 查看云助手版本。

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

    3. 创建region-id文件并填入ECS实例所属地域的ID。
      • Linux:
        在云助手的安装目录下,创建名为 region-id的文件,并在 region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例,创建 region-id文件并添加 cn-hangzhou地域ID的命令如下:
        • CoreOS操作系统:
          echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id
        • 其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):
          echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id
        以其他操作系统(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)为例,回显如下: 创建文件
      • Windows:
        1. 在云助手的安装目录下,创建名为region-id的文件(不要添加类似.txt.conf的扩展名)。
          重要 Windows系统会隐藏已知文件类型的扩展名,您必须设置显示已知文件类型的扩展名才能真正判断 region-id是否带有扩展名。
        2. region-id文件中填入ECS实例所属地域的ID,例如cn-hangzhou
        以Windows Server 2012 R2为例,在云助手默认安装路径 C:\ProgramData\aliyun\assist\下新建的 region-id文件及填入 cn-hangzhou地域ID的示例结果如下: 在Windows上添加文件

查看ECS实例的云助手客户端信息

您安装好云助手客户端后,可以通过以下步骤查看ECS实例的云助手客户端版本号、状态等信息。

  1. 登录ECS管理控制台
  2. 在左侧导航栏,选择运维与监控 > 发送命令/文件(云助手)
  3. 在顶部菜单栏左上角处,选择地域。
  4. 单击ECS实例页签,查看当前地域ECS实例上的云助手客户端信息。
    查询结果