AI 助理
备案控制台
文档
输入文档关键字查找
首页 云服务器 ECS 操作指南 运维与监控 云助手 配置云助手Agent 升级或禁止升级云助手Agent

升级或禁止升级云助手Agent

更新时间：
产品详情
相关技术圈
我的收藏

云助手支持的功能取决于所使用的云助手版本。若当前版本的云助手不支持某一功能，您可能需要升级云助手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的具体版本号。

上一篇：启动、停止或者卸载云助手Agent下一篇：配置云助手Agent网络权限
文档推荐