全部產品
Search

搜尋本產品

    Elastic Compute Service：在ECS執行個體中安裝雲助手Agent

    文件中心

    Elastic Compute Service：在ECS執行個體中安裝雲助手Agent

    更新時間：Oct 25, 2024

    雲助手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

    通過雲助手上傳檔案到ECS執行個體

    執行命令支援指定使用者名稱稱

    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（Debian和Ubuntu等）

    說明

    RHEL不支援通過阿里雲CLI安裝。

    Linux（其他）

    Windows執行個體安裝雲助手Agent

    1. 以管理員帳號遠端連線ECS執行個體。

      具體操作，請參見ECS遠端連線方式概述。

    2. 下載雲助手Agent。

      雲助手Agent下載地址：

      • 公網地址（最新版本）：雲助手Agent最新版本。

      • 公網地址（指定版本）：

        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}為雲助手Agent的具體版本號碼。

      • {regionId}為您執行個體所在的地區的Region ID。

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

      • 公網地址和內網地址支援指定下載的雲助手版本號碼如下。

        • 公網地址：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

      例如在杭州內網下載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. 雙擊雲助手Agent檔案，根據安裝嚮導完成安裝。

      如果您選擇預設安裝路徑，雲助手Agent在Windows執行個體中的安裝目錄為C:\ProgramData\aliyun\assist\。

      您也可以將上述下載和安裝的步驟整合成powershell指令碼，以下指令碼以內網最新版本地址為例，使用時請將{regionId}替換為您執行個體所在的地區的Region ID。 

      curl -UseBasicParsing -Uri https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
&"C:\\aliyun_agent_latest_setup.exe" '/S'

    4. （可選）如果ECS執行個體的網路類型為傳統網路，需要執行以下操作。

      1. 在雲助手的安裝目錄下，建立名為region-id的檔案（不要添加類似.txt或.conf的副檔名）。

        重要

        Windows系統會隱藏已知檔案類型的副檔名，您必須設定顯示已知檔案類型的副檔名才能真正判斷region-id是否帶有副檔名。

      2. 在region-id檔案中填入ECS執行個體所屬地區的ID，例如cn-hangzhou。

        說明

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

      以Windows Server 2012 R2為例，在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下：在Windows上添加檔案

    Linux執行個體安裝雲助手Agent

    rpm包管理方式

    適合Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等作業系統。

    1. 以sudo許可權的使用者遠端連線ECS執行個體。

      具體操作，請參見ECS遠端連線方式概述。

    2. 下載雲助手Agent rpm包。

      雲助手Agent版本

      下載命令

      公網地址（最新版本）

      x86版本

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

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"

      公網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"

      內網地址（最新版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"

      內網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"
      說明

      • {version}為雲助手Agent的具體版本號碼。

      • {regionId}為您執行個體所在的地區的Region ID。

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

      • 公網地址和內網地址支援指定下載的雲助手版本號碼如下。

        • 公網地址：

          • 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

      例如在杭州內網地址下載1.0.2.458 x86版本，則對應地址如下所示。

      sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"

    3. 安裝雲助手Agent。

      如果您選擇預設安裝路徑，則雲助手Agent在Linux執行個體中的安裝目錄為：

      • CoreOS作業系統：/opt/local/share/aliyun-assist/

      • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/

      此樣本表示安裝最新版本雲助手Agent。

      • x86版本

        sudo rpm -ivh --force aliyun_assist_latest.rpm

      • ARM版本

        sudo rpm -ivh --force aliyun-assist-latest-1.aarch64.rpm

    4. 根據ECS執行個體的作業系統或網路類型不同，判斷是否需要執行以下不同操作。

      • 如果ECS執行個體的作業系統為RedHat，執行以下操作。

        1. 關閉qemu-ga服務。

          sudo systemctl stop qemu-guest-agent
sudo systemctl disable qemu-guest-agent

        2. 重啟雲助手服務。

          sudo systemctl restart aliyun.service

      • 如果ECS執行個體的網路類型為傳統網路，執行以下操作。

        在雲助手的安裝目錄下，建立名為region-id的檔案，並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例，建立region-id檔案並添加cn-hangzhou地區ID的命令如下：

        • CoreOS作業系統：

          sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

        • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

          sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

        以其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）為例，回顯如下：建立檔案

    deb包管理方式

    適合Debian和Ubuntu等作業系統。

    1. 以sudo許可權的使用者遠端連線ECS執行個體。

      具體操作，請參見ECS遠端連線方式概述。

    2. 下載雲助手Agent deb包。

      雲助手Agent版本

      下載命令

      公網地址（最新版本）

      x86版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"

      公網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.deb"

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"

      內網地址（最新版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.deb"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"

      內網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.deb"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"
      說明

      • {version}為雲助手Agent的具體版本號碼。

      • {regionId}為您執行個體所在的地區的Region ID。

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

      • 公網地址和內網地址支援指定下載的雲助手版本號碼如下。

        • 公網地址：

          • 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

      例如在杭州內網地址下載1.0.2.458 x86版本，則對應地址如下所示。

      sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.deb"

    3. （可選）如果ECS執行個體中已經安裝過雲助手，卸載舊版本。

      sudo dpkg -r aliyun-assist

    4. 安裝雲助手Agent。

      如果您選擇預設安裝路徑，則雲助手Agent在Linux執行個體中的安裝目錄為：

      • CoreOS作業系統：/opt/local/share/aliyun-assist/

      • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/

      此樣本表示安裝最新版本雲助手Agent。

      • x86版本

        sudo dpkg -i aliyun_assist_latest.deb

      • ARM版本

        sudo dpkg -i aliyun-assist_latest-1_arm64.deb

    5. 如果ECS執行個體的網路類型為傳統網路，執行以下操作。

      在雲助手的安裝目錄下，建立名為region-id的檔案，並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例，建立region-id檔案並添加cn-hangzhou地區ID的命令如下：

      • CoreOS作業系統：

        sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

      • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

        sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

      以其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）為例，回顯如下：建立檔案

    binary安裝方式

    適合主流Linux作業系統。

    1. 以sudo許可權的使用者遠端連線ECS執行個體。

      具體操作，請參見ECS遠端連線方式概述。

    2. 下載雲助手Agent binary包。

      雲助手Agent版本

      下載命令

      公網地址（最新版本）

      x86版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest_update.zip"

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"

      公網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"

      ARM版本

      sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"

      內網地址（最新版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest_update.zip"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"

      內網地址（指定版本）

      x86版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"

      ARM版本

      sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"
      說明

      • {version}為雲助手Agent的具體版本號碼。

      • {regionId}為您執行個體所在的地區的Region ID。

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

      • 公網地址和內網地址支援指定下載的雲助手版本號碼如下。

        • x86版本：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

      例如在杭州內網地址下載2.2.3.282 x86版本，則對應地址如下所示。 

      sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_2.2.3.282_update.zip"

    3. 安裝雲助手Agent。

      如果您選擇預設安裝路徑，則雲助手Agent在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版本的雲助手Agent為例。

      sudo unzip  -o aliyun_assist_2.2.3.282_update.zip -d /usr/local/share/aliyun-assist/
sudo chmod a+x /usr/local/share/aliyun-assist/2.2.3.282/update_install
sudo bash /usr/local/share/aliyun-assist/2.2.3.282/update_install

    4. 根據ECS執行個體的作業系統或網路類型不同，判斷是否需要執行以下不同操作。

      • 如果ECS執行個體的作業系統為RedHat，執行以下操作。

        1. 關閉qemu-ga服務。

          sudo systemctl stop qemu-guest-agent
sudo systemctl disable qemu-guest-agent

        2. 重啟雲助手服務。

          sudo systemctl restart aliyun.service

      • 如果ECS執行個體的網路類型為傳統網路，執行以下操作。

        在雲助手的安裝目錄下，建立名為region-id的檔案，並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例，建立region-id檔案並添加cn-hangzhou地區ID的命令如下：

        • CoreOS作業系統：

          sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

        • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

          sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

        以其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）為例，回顯如下：建立檔案

    原始碼安裝方式

    1. 以sudo許可權的使用者遠端連線ECS執行個體。

      具體操作，請參見ECS遠端連線方式概述。

    2. 安裝Git和Go等必要的軟體。

      此樣本通過yum安裝，如果您使用其他Linux版本，請修改為對應的包管理工具。

      • 安裝Git：

        sudo yum install git -y

      • 安裝Go：

        sudo yum install go -y

    3. 下載雲助手Agent源碼。

      sudo git clone https://github.com/aliyun/aliyun_assist_client

    4. 進入源碼存放目錄。

      cd ./aliyun_assist_client

    5. 編譯源碼。

      sudo go build

      如果返回結果無報錯資訊，表示安裝成功。

    6. 如果ECS執行個體的網路類型為傳統網路，執行以下操作。

      在雲助手的安裝目錄下，建立名為region-id的檔案，並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例，建立region-id檔案並添加cn-hangzhou地區ID的命令如下：

      • CoreOS作業系統：

        sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

      • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

        sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

      以其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）為例，回顯如下：建立檔案

    7. 運行雲助手Agent。

      aliyun-service -d

    通過阿里雲CLI安裝雲助手Agent（Windows或Linux執行個體）

    通過阿里雲CLI安裝用戶端，可免除遠端連線執行個體的步驟，請確保您已經為本地用戶端安裝了阿里雲CLI，在不同作業系統中安裝CLI的方式如下：

    說明

    RHEL不支援通過阿里雲CLI安裝。

    1. 調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。 

      aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

      返回CloudAssistantStatus=true時，表示ECS執行個體已安裝雲助手Agent。否則，請繼續下一步。

    2. 調用InstallCloudAssistant安裝雲助手Agent。

      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執行個體。

        具體操作，請參見ECS遠端連線方式概述。

      2. 查看雲助手版本。

        如果雲助手Agent版本高於1.0.1.400，雲助手Agent安裝成功；否則，繼續下一步操作。

      3. 建立region-id檔案並填入ECS執行個體所屬地區的ID。

        Linux

        在雲助手的安裝目錄下，建立名為region-id的檔案，並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例，建立region-id檔案並添加cn-hangzhou地區ID的命令如下：

        • CoreOS作業系統：

          sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

        • 其他動作系統（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

          sudo sh -c '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。

          說明

          您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區，然後在地區和可用性區域中查看對應的地區ID。

        以Windows Server 2012 R2為例，在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下：在Windows上添加檔案

    查看ECS執行個體的雲助手Agent資訊

    您安裝好雲助手Agent後，可以通過以下步驟查看ECS執行個體的雲助手Agent版本號碼、狀態等資訊。

    1. 登入ECS管理主控台。

    2. 在左側導覽列，選擇營運與監控 > 雲助手。

    3. 在頁面左側頂部，選擇目標資源所在的資源群組和地區。地區

    4. 單擊ECS執行個體頁簽，查看當前地區ECS執行個體上的雲助手Agent資訊。

      查詢結果

    部分核心版本號碼允許升級雲助手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