雲助手用戶端是為ECS執行個體執行雲助手命令的代理程式。本文提供安裝、升級、停止以及啟動雲助手用戶端的操作指示。

通過下載連結安裝用戶端

说明
  • 2017年12月01日之後使用公用鏡像建立的ECS執行個體,預設預裝雲助手用戶端。如果您的執行個體是2017年12月01日之前購買的,若需要使用雲助手相關功能,請自行安裝雲助手用戶端。
  • 使用自訂鏡像或者雲市場鏡像建立的ECS執行個體,請參見雲助手查詢您的執行個體規格以及作業系統是否能使用雲助手服務,再自行安裝用戶端。

Windows執行個體以下步驟安裝用戶端。

  1. 遠端連線Windows執行個體
  2. 下載雲助手用戶端
  3. 雙擊用戶端檔案,根據安裝嚮導完成安裝。
    说明 如果您選擇預設安裝路徑,則用戶端在Windows執行個體中的安裝目錄為C:\ProgramData\aliyun\assist\
  4. (僅傳統網路類型執行個體)在雲助手的安裝目錄下建立名為region-id的檔案,在檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。更多取值請參見地區和可用性區域

Linux執行個體需要根據您的作業系統,選擇下列安裝方式的其中一種。

  • RPM包安裝,適合CentOS、RHEL和SUSE Linux等作業系統:
    1. 遠端連線Linux執行個體
    2. 運行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm下載雲助手用戶端rpm包
    3. 運行rpm -ivh aliyun_assist.rpm安裝雲助手用戶端。
    4. (僅傳統網路類型執行個體)在雲助手的安裝目錄下建立名為region-id的檔案,在檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。更多取值請參見地區和可用性區域
  • deb包安裝,適合Debian和Ubuntu等作業系統:
    1. 遠端連線Linux執行個體。
    2. 運行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.deb下載雲助手用戶端deb包。
    3. 運行dpkg -i aliyun_assist.deb安裝雲助手用戶端。
    4. (僅傳統網路類型執行個體)在雲助手的安裝目錄下建立名為region-id的檔案,在檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。更多取值請參見地區和可用性區域
  • 源碼編譯安裝:
    1. 遠端連線Linux執行個體。
    2. 運行git clone https://github.com/aliyun/aliyun_assist_client下載雲助手用戶端源碼。
    3. 進入源碼存放目錄。
    4. 運行cmake .產生編譯檔案。
      说明 若編譯時間報錯CMAKE_MINIMUM_REQUIRED,請前往CMake官網升級CMake服務至3.1及以上版本。
    5. 運行make開始編譯。
    6. 運行./cmake_install.sh安裝雲助手用戶端。
    7. (僅傳統網路類型執行個體)在雲助手的安裝目錄下建立名為region-id的檔案,在檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。更多取值請參見地區和可用性區域
说明 如果您選擇預設安裝路徑,則用戶端在Linux執行個體中的安裝目錄為:
  • CoreOS作業系統:/opt/local/share/aliyun-assist/
  • 其他動作系統(Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、OpenSUSE和Aliyun Linux等):/usr/local/share/aliyun-assist/

通過阿里雲CLI安裝用戶端

前提條件

  • 本樣本在命令列工具中完成,請確保您已經安裝了阿里雲命令列工具CLI。如何擷取和安裝阿里雲CLI,請參見阿里雲命令列工具CLI
  • 已擷取地區ID,樣本命令中需要填寫。詳細的地區ID,請參見地區和可用性區域

操作步驟

  1. 調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手用戶端。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp --output cols=CloudAssistantStatus
    當返回CloudAssistantStatus=true結果時,表示您的ECS執行個體已安裝雲助手用戶端。否則請繼續進入下一步。
  2. 調用InstallCloudAssistant為ECS執行個體安裝雲助手用戶端。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp
  3. 調用RebootInstance重啟目標ECS執行個體。
    aliyun ecs RebootInstance --RegionId TheRegionId --InstanceId i-bp1g6zv0ce8ogXXXXXXp
  4. (僅傳統網路類型執行個體)在雲助手的安裝目錄下建立名為region-id的檔案,在檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。更多取值請參見地區和可用性區域

升級用戶端

雲助手用戶端每隔一個小時會運行升級資源檢測進程,該進程程式所在路徑為:

  • Windows執行個體:C:\ProgramData\aliyun\assist\${version}/aliyun_assist_update
  • Linux執行個體:/usr/local/share/aliyun-assist/${version}/aliyun_assist_update
自動升級失效時,您可以建立升級命令CreateCommand),定期執行。以RPM安裝包為例,以下雲助手命令可以升級雲助手用戶端:
wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm
rpm -U aliyun_assist.rpm

禁止升級用戶端

雲助手用戶端升級進程預設自啟動,您也可以禁用該服務:

  • Windows執行個體:在命令提示字元視窗CMD中運行rename aliyun_assist_update
  • Linux執行個體:運行chmod a-x aliyun_assist_update

停止或啟動用戶端

Windows執行個體

  1. 遠端連線Windows執行個體
  2. 選擇電腦管理 > 服務和應用程式 > 服務,並找到AliyunService
    警告 AliyunService是雲助手用戶端服務的運行名稱,停止AliyunService相當於停止雲助手用戶端,這可能會導致ECS執行個體異常,並無法在ECS管理主控台停止運行中的ECS執行個體。建議您謹慎停止雲助手用戶端。
  3. 單擊停止此服務或者重啟動此服務
    重啟動此服務

Linux執行個體

  1. 遠端連線Linux執行個體
  2. 運行以下命令檢查雲助手用戶端的版本。
    aliyun-service -v
    说明 對於高於1.0.1.308版本的雲助手用戶端,不再使用agentwatch管理雲助手用戶端服務。因此,您需要根據返回的雲助手用戶端版本號碼決定如何停止或者啟動雲助手用戶端。
  3. 根據返回的雲助手用戶端版本選擇操作方式。
    • 對於1.0.1.308及更低版本的雲助手用戶端,請根據ECS執行個體的init系統選擇以下命令停止雲助手用戶端服務。
      • Debian、CentOS和Red Hat等作業系統:
        #停止雲助手用戶端
        systemctl stop agentwatch
        #啟動雲助手用戶端
        systemctl start agentwatch
      • 使用其他init系統的作業系統:
        #停止雲助手用戶端
        chkconfig agentwatch off
        #啟動雲助手用戶端
        chkconfig agentwatch on
    • 對於高於1.0.1.308版本的雲助手用戶端,請根據ECS執行個體的init系統選擇以下命令停止雲助手用戶端服務。
      • 採用新版本核心的Linux系統通常使用systemd初始化進程服務,操作如下:
        #查詢您的ECS執行個體是否使用systemd初始化進程服務,有返回資訊則表示使用的是systemd
        strings /sbin/init | grep "/lib/system"
        #停止雲助手用戶端
        systemctl stop aliyun.service
        #啟動雲助手用戶端
        systemctl start aliyun.service
      • 對於Ubuntu14及更低版本的Linux系統,通常使用UpStart初始化進程服務,操作如下:
        #查詢您的ECS執行個體是否使用UpStart初始化進程服務,有返回資訊則表示使用的是UpStart
        strings /sbin/init | grep "upstart"
        #停止雲助手用戶端
        /sbin/initctl stop aliyun-service
        #啟動雲助手用戶端
        /sbin/initctl start aliyun-service
      • 採用低版本核心的Linux系統通常使用sysvinit初始化進程服務,操作如下:
        #查詢您的ECS執行個體是否使用sysvinit初始化進程服務,有返回資訊則表示使用的是sysvinit
        strings /sbin/init | grep "sysvinit"
        #停止雲助手用戶端
        /etc/init.d/aliyun-service stop
        #啟動雲助手用戶端
        /etc/init.d/aliyun-service start

相關連結