赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 云服务器 ECS
  4. 操作指南
  5. 运维与监控
  6. 云助手
  7. 配置云助手Agent
  8. 升级或禁止升级云助手Agent

升级或禁止升级云助手Agent

  • 配置云助手Agent
  • 发布于 2025-04-01
  • 0 次阅读
文档编辑
文档编辑

云助手支持的功能取决于所使用的云助手版本。若当前版本的云助手不支持某一功能,您可能需要升级云助手Agent,本文介绍如何升级和禁止升级云助手Agent。

云助手支持的功能与支持该功能的云助手最低版本号,请参见安装云助手Agent。

使用限制

  • 需要升级云助手Agent的ECS实例处于运行中状态。

  • 请确认您已安装云助手Agent。具体操作,请参见安装云助手Agent。

自动升级

云助手Agent默认每隔30分钟会自动运行升级程序aliyun_assist_update,该程序所在路径为:

  • Windows实例:C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe

  • Linux实例:/usr/local/share/aliyun-assist/{version}/aliyun_assist_update

说明

{version}为云助手Agent的具体版本号。

您可以配置云助手Agent的自动升级策略,控制允许升级的时间段,规避在业务高峰期Agent升级的影响。

  1. 登录ECS管理控制台。

  2. 在左侧导航栏,选择运维与监控 > 云助手。

  3. 在云助手页面右上角,单击设置。

    image

  4. 在弹出的云助手设置对话框中,单击云助手Agent升级设置页签。

  5. 选中云助手Agent升级设置复选框,设置允许升级的时间段和时区,然后单击确定。

    说明

    最多可输入5组时间段,且每组时间段的间隔不能短于1小时。

    image

手动升级

通过公共命令升级

自动升级失效时,您可以调用公共命令进行升级。

重要

下文以控制台操作为例,如何通过OpenAPI或CLI方式使用云助手公共命令,请参见查看和执行公共命令。

  1. 登录ECS管理控制台。

  2. 在左侧导航栏,选择运维与监控 > 云助手。

  3. 在ECS云助手页面,单击公共命令页签。

  4. 找到如下待执行的公共命令(选择最新版本),单击执行。

    • Linux实例:ACS-ECS-UpdateAliyunAssist-linux.sh。

    • Windows实例:ACS-ECS-UpdateAliyunAssist-windows.ps1。

      image.png

  5. 在执行命令面板中,按照界面提示配置相关参数并单击执行。

    • 执行计划:选择命令执行的时间。更多信息,请参见执行计划详细信息。

    • 选择实例:选择需要升级云助手的实例,该实例需处于运行中状态且已安装云助手的客户端。

      更多参数说明,请参见查看和执行公共命令。

      当执行结果类似如下所示时,说明云助手Agent已升级成功。image.png

      说明

      如果公共命令执行失败,请查看错误信息并根据诊断信息修复问题,更多信息,请参见执行失败常见错误及修复建议。

手动下载安装包升级

您也可以手动下载最新的安装包进行升级。具体操作,请参见安装云助手Agent。

示例:以RPM包为例,执行以下命令为x86架构的Linux实例下载并安装最新的云助手安装包。

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

手动禁止升级

通过禁用自动升级程序禁止升级

您可以通过禁用自动升级程序aliyun_assist_update来禁止升级云助手Agent:

  • Windows Server系统:在PowerShell中运行以下命令。

    Rename-Item -Path 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe'-NewName 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe.bk'
  • Linux系统:运行以下命令。

    mv /usr/local/share/aliyun-assist/{version}/aliyun_assist_update /usr/local/share/aliyun-assist/{version}/aliyun_assist_update.bk
说明

{version}为云助手Agent的具体版本号。

通过配置文件禁止升级

对于Linux操作系统下版本号不低于2.2.1.140的云助手Agent和Windows操作系统下版本号不低于2.1.1.140的云助手Agent,您可以通过云助手Agent在指定路径下创建配置文件来禁止升级云助手Agent:

  • 禁止云助手Agent启动时检查升级

    在云助手Agent安装目录内的config目录下创建文件disable_bootstrap_update即可禁用当前版本的云助手Agent启动时检查升级,在跨版本目录内的config目录下创建该文件可禁用本机上所有版本的云助手Agent启动时检查升级。disable_bootstrap_update文件不需要写入任何内容。

    • Windows Server系统:在PowerShell中运行以下命令。

      # 例如执行以下命令将会禁止指定版本号的云助手Agent启动时的检查升级
      New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_bootstrap_update
      # 例如执行以下命令禁止云助手Agent启动时检查升级,对各个版本都有效
      New-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update
    • Linux系统:运行以下命令。

      # 例如执行以下命令将会禁止指定版本号的云助手Agent启动时的检查升级
      touch /usr/local/share/aliyun-assist/{version}/config/disable_bootstrap_update
      # 例如执行以下命令禁止云助手Agent启动时检查升级,对各个版本都有效
      touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
    说明

    {version}为云助手Agent的具体版本号。

  • 禁止云助手Agent自动检查更新

    在云助手Agent安装目录内的config目录下创建文件disable_update即可禁用该版本的云助手Agent自动升级,在跨版本目录内的config目录下创建该文件可禁用本机上所有版本的云助手Agent自动升级。disable_update文件不需要写入任何内容。

    • Windows Server系统:在PowerShell中运行以下命令。

      # 例如执行以下命令将会禁止指定版本号的云助手Agent的自动升级
      New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_update
      # 例如执行以下命令禁止云助手Agent的自动升级,对各个版本都有效
      New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
    • Linux系统:运行以下命令。

      # 例如执行以下命令将会禁止指定版本号的云助手Agent的自动升级
      touch /usr/local/share/aliyun-assist/{version}/config/disable_update
      # 例如执行以下命令禁止云助手Agent的自动升级,对各个版本都有效
      touch /usr/local/share/aliyun-assist/config/disable_update
    说明

    {version}为云助手Agent的具体版本号。

相关文章

为云助手配置域名解析 2025-04-01 12:00

本文介绍如何为云助手配置域名解析,即获取相关服务域名的IP并修改hosts文件。 操作场景 使用云助手的功能时(例如执行云助手命令),ECS实例需要能访问相关的服务域名才能完成您指定的动作。ECS实例中配置了默认的DNS Nameserver,用于云

升级或禁止升级云助手Agent 2025-04-01 12:00

云助手支持的功能取决于所使用的云助手版本。若当前版本的云助手不支持某一功能,您可能需要升级云助手Agent,本文介绍如何升级和禁止升级云助手Agent。 云助手支持的功能与支持该功能的云助手最低版本号,请参见安装云助手Agent

启动、停止或者卸载云助手Agent 2025-04-01 12:00

云助手Agent是为ECS实例执行云助手命令的代理程序。本文介绍如何启动、停止或卸载云助手Agent。 启动或停止

安装云助手Agent 2025-04-01 12:00

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

查看云助手状态及异常状态处理 2025-04-01 12:00

本文介绍如何查看云助手状态,以及云助手状态异常时如何处理。 查看云助手状态

配置云助手Agent网络权限 2025-04-01 12:00

本文介绍如何为云助手Agent所在实例配置安全组规则,从而更方便地管理云助手Agent的网络权限。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号