助手Agent是为ECS实例执行云助手命令的程序。本文介绍如何安装云助手Agent。
查询您的实例规格以及操作系统是否能使用云助手后，再自行安装云助手Agent。更多信息，请参见使用限制。 2017年12月01日之后使用公共镜像创建的ECS实例，默认预装了云助手Agent。 如果您的实例是2017年12月01日之前购买的或使用自行上传的自定义镜像创建的实例，若需要使用云助手相关功能，请参考本文自行安装云助手Agent。 说明 将非阿里云服务器注册为阿里云托管实例，该服务器即可使用阿里云提供的多种在线服务（例如云助手、系统运维管理和云效）来管理或使用该服务器。更多信息，请参见阿里云托管实例。 您需要根据云助手支持的功能来安装对应版本的云助手。云助手支持的功能与支持该功能的云助手最低版本号如下表所示。 云助手支持的功能 云助手最低版本号（Linux实例） 云助手最低版本号（Windows实例） 相关文档 支持上报云助手心跳 1.0.2.458 1.0.0.149 无 发送文件 1.0.2.569 1.0.0.149 执行命令支持指定用户名称 2.2.0.106 2.1.0.50 支持设置实例下次启动时执行命令 2.2.0.46 2.1.0.50 支持设置实例每次启动时执行命令 支持会话管理（Session Manager） 2.2.3.196 2.1.3.196 定时任务的执行规则支持Rate表达式、At表达式 2.2.3.282 2.1.3.282 定时任务的执行规则中，Cron表达式支持指定年份或时区 2.2.3.282 2.1.3.282 支持内置环境参数 2.2.3.309 2.1.3.309 支持将实例名称作为内置环境参数 2.2.3.344 2.1.3.344 支持通过指定特殊退出码停止或重启实例 2.2.3.317 2.1.3.317 支持通过指定容器名称，在容器内执行命令 2.2.3.344 2.1.3.344 支持通过指定容器ID，在容器内执行命令 2.2.3.344 2.1.3.344 不同操作系统可选择的安装方式如下表所示。 实例操作系统 选择安装方式 Windows Linux（Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等） Linux实例安装云助手Agent Linux（Debian和Ubuntu等） Linux实例安装云助手Agent 说明 RHEL不支持通过阿里云CLI安装。 Linux（其他） Linux实例安装云助手Agent 以管理员账号远程连接ECS实例。 具体操作，请参见连接方式概述。 下载云助手Agent。 云助手Agent下载地址： 说明 例如在杭州内网下载1.0.0.128版本，则对应地址如下所示。 公网地址：1.0.0.128、2.1.2.181、2.1.3.187、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398 内网地址：1.0.0.128、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.265、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398 {version}为云助手Agent的具体版本号。 {regionId}为您实例所在的地域的Region ID。 您可以在ECS控制台上的实例详情页面基本信息区域查看ECS实例所属地域，然后在地域和可用区中查看对应的地域ID。 公网地址和内网地址支持指定下载的云助手版本号如下。 公网地址（最新版本）：云助手Agent最新版本。 公网地址（指定版本）： 内网地址（最新版本）： 内网地址（指定版本）： 双击云助手Agent文件，根据安装向导完成安装。 如果您选择默认安装路径，云助手Agent在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\。 （可选）如果ECS实例的网络类型为经典网络，需要执行以下操作。 以Windows Server 2012 R2为例，在云助手默认安装路径C:\ProgramData\aliyun\assist\下新建的region-id文件及填入cn-hangzhou地域ID的示例结果如下： 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。 重要 Windows系统会隐藏已知文件类型的扩展名，您必须设置显示已知文件类型的扩展名才能真正判断region-id是否带有扩展名。 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。 说明 您可以在ECS控制台上的实例详情页面基本信息区域查看ECS实例所属地域，然后在地域和可用区中查看对应的地域ID。 rpm包管理方式 deb包管理方式 binary安装方式 源代码安装方式 适合Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等操作系统。 以sudo权限的用户远程连接ECS实例。 具体操作，请参见连接方式概述。 下载云助手Agent rpm包。 云助手Agent版本 下载命令 公网地址（最新版本） x86版本 ARM版本 公网地址（指定版本） x86版本 ARM版本 内网地址（最新版本） x86版本 ARM版本 内网地址（指定版本） x86版本 ARM版本 说明 例如在杭州内网地址下载1.0.2.458 x86版本，则对应地址如下所示。 公网地址： 内网地址： x86版本：1.0.1.413、1.0.1.414、1.0.1.448、1.0.1.450、1.0.2.458、1.0.2.479、1.0.2.541、1.0.2.569、1.0.2.574、2.2.0.102、2.2.0.106、2.2.2.181、2.2.3.187、2.2.3.221、2.2.3.247、2.2.3.256、2.2.3.269、2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398 ARM版本：2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398 x86版本：1.0.1.407、1.0.2.458、1.0.2.479、2.2.3.221、2.2.3.247、2.2.3.256、2.2.3.265、2.2.3.269、2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398 ARM版本：2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398 {version}为云助手Agent的具体版本号。 {regionId}为您实例所在的地域的Region ID。 您可以在ECS控制台上的实例详情页面基本信息区域查看ECS实例所属地域，然后在地域和可用区中查看对应的地域ID。 公网地址和内网地址支持指定下载的云助手版本号如下。 安装云助手Agent。 如果您选择默认安装路径，则云助手Agent在Linux实例中的安装目录为： 此示例表示安装最新版本云助手Agent。 x86版本 ARM版本 CoreOS操作系统：/opt/local/share/aliyun-assist/ 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/ 根据ECS实例的操作系统或网络类型不同，判断是否需要执行以下不同操作。 CoreOS操作系统： 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）： 如果ECS实例的操作系统为RedHat，执行以下操作。 如果ECS实例的网络类型为经典网络，执行以下操作。 在云助手的安装目录下，创建名为region-id的文件，并在region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例，创建region-id文件并添加cn-hangzhou地域ID的命令如下： 以其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）为例，回显如下： 关闭qemu-ga服务。 重启云助手服务。 通过阿里云CLI安装客户端，可免除远程连接实例的步骤，请确保您已经为本地客户端安装了阿里云CLI，在不同操作系统中安装CLI的方式如下： 说明 RHEL不支持通过阿里云CLI安装。 调用DescribeCloudAssistantStatus查询目标ECS实例是否安装了云助手Agent。 返回 调用InstallCloudAssistant安装云助手Agent。 调用RebootInstance重启ECS实例。 如果ECS实例的网络类型为经典网络，在实例内部添加所属地域声明。 CoreOS操作系统： 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）： Linux：运行以下命令。 Windows：具体操作，请参见升级或禁止升级云助手Agent。 以root/system权限远程连接ECS实例。 具体操作，请参见连接方式概述。 查看云助手版本。 如果云助手Agent版本高于1.0.1.400，云助手Agent安装成功；否则，继续下一步操作。 创建region-id文件并填入ECS实例所属地域的ID。 Linux Windows 在云助手的安装目录下，创建名为region-id的文件，并在region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例，创建region-id文件并添加cn-hangzhou地域ID的命令如下： 以其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）为例，回显如下： 您安装好云助手Agent后，可以通过以下步骤查看ECS实例的云助手Agent版本号、状态等信息。 登录ECS管理控制台。 在左侧导航栏，选择。 在页面左侧顶部，选择目标资源所在的资源组和地域。 单击ECS实例页签，查看当前地域ECS实例上的云助手Agent信息。 实例的内核版本号 云助手Agent可升级的最高版本 Linux内核版本号小于2.6.32 X86/X64架构：2.2.3.398 ARM架构：2.4.3.398 FreeBSD 11及以下（内核版本号小于12.x） 2.3.3.529前提条件
背景信息
Windows实例安装云助手Agent
https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_1.0.0.128_setup.exe
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_{version}_setup.exehttps://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exehttps://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe
Linux实例安装云助手Agent
sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"
sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"
sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"
sudo rpm -ivh --force aliyun_assist_latest.rpm
sudo rpm -ivh --force aliyun-assist-latest-1.aarch64.rpm
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
sudo systemctl stop qemu-guest-agent
sudo systemctl disable qemu-guest-agent
sudo systemctl restart aliyun.service
通过阿里云CLI安装云助手Agent（Windows或Linux实例）
aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]
CloudAssistantStatus=true时，表示ECS实例已安装云助手Agent。否则，请继续下一步。aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p
aliyun ecs RebootInstance --InstanceId i-bp1g6zv0ce8og******p
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
aliyun-service -v
查看ECS实例的云助手Agent信息
部分内核版本号允许升级云助手Agent的最高版本
