全部產品
Search
文件中心

Elastic Compute Service:升級或禁止升級雲助手Agent

更新時間:Jun 19, 2024

雲助手支援的功能取決於所使用的雲助手版本。若目前的版本的雲助手不支援某一功能,您可能需要升級雲助手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的具體版本號碼。