2017年12月01日之後使用公用鏡像建立的ECS執行個體,已預設預裝雲助手Agent。如果您的執行個體是在2017年12月01日之前購買,或是通過自行上傳的自訂鏡像建立,或者是第三方雲端服務器,若要使用雲助手相關功能,則需為該ECS執行個體安裝雲助手Agent。
注意事項
請確認您的作業系統是否支援安裝雲助手。有關支援的作業系統資訊,請參見使用限制。
若作業系統支援雲助手,請參考本文自行安裝雲助手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
在使用雲助手支援的某項功能時,該功能對雲助手的版本存在一定的要求。具體資訊,請參見支援功能及版本。
若您想要將第三方雲端服務器註冊為阿里雲受管理的執行個體,請參見阿里雲受管理的執行個體。
通過程式包方式安裝
Windows系統安裝步驟
以管理員帳號遠端連線ECS執行個體。
具體操作,請參見通過密碼認證登入Windows執行個體。
下載雲助手Agent。
雲助手Agent下載地址:
公網地址(最新版本):下載地址。
內網地址(最新版本):
https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
其中{regionId}為您執行個體所在的地區的Region ID。例如在杭州內網下載最新版本,則對應地址如下所示。
https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
雙擊雲助手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'
(可選)如果ECS執行個體的網路類型為傳統網路,需要執行以下操作。
在雲助手的安裝目錄下,建立名為region-id的檔案(不要添加類似.txt或.conf的副檔名)。
重要Windows系統會隱藏已知檔案類型的副檔名,您必須設定顯示已知檔案類型的副檔名才能真正判斷region-id是否帶有副檔名。
在region-id檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。
說明您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區,然後在地區和可用性區域中查看對應的地區ID。
以Windows Server 2012 R2為例,在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下:
Linux系統安裝步驟
RPM和DEB包管理方式
適合Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian和Ubuntu等作業系統。
以sudo許可權的使用者遠端連線ECS執行個體。
具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體。
執行如下指令碼,完成雲助手安裝包的下載與安裝。
重要以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中
VERSION=latest
修改為指定的版本號碼,例如VERSION=2.2.3.398
。內網下載安裝指令碼
推薦,適用於ECS執行個體,預設可以通過內網下載。
#!/bin/bash VERSION=latest PACKAGE= PKG_URI= REGION=$(curl http://100.100.100.200/latest/meta-data/region-id) DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com arch=$(uname -m) echo "[main] arch = ${arch}" case $arch in "i386"|"i686"|"x86_64"|"amd64") if command -v rpm; then PACKAGE="aliyun_assist_${VERSION}.rpm" else PACKAGE="aliyun_assist_${VERSION}.deb" fi PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) if command -v rpm; then PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm" else PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb" fi PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then curl -o $PACKAGE $PKG_URI else echo "[WARN] command wget/curl not found, exit" exit 1; fi; if command -v rpm; then sudo rpm -ivh --force $PACKAGE elif command -v dpkg; then sudo dpkg -i $PACKAGE else echo "[WARN] command rpm/dpkg not found, exit" exit 2; fi if [[ -e /etc/redhat-release ]]; then if sudo systemctl status qemu-guest-agent; then sudo systemctl stop qemu-guest-agent sudo systemctl disable qemu-guest-agent sudo systemctl restart aliyun.service fi fi
公網下載安裝指令碼
適用於非阿里雲主機以及可出公網的ECS執行個體。
#!/bin/bash VERSION=latest PACKAGE= PKG_URI= DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com arch=$(uname -m) echo "[main] arch = ${arch}" case $arch in "i386"|"i686"|"x86_64"|"amd64") if command -v rpm; then PACKAGE="aliyun_assist_${VERSION}.rpm" else PACKAGE="aliyun_assist_${VERSION}.deb" fi PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) if command -v rpm; then PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm" else PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb" fi PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then curl -o $PACKAGE $PKG_URI else echo "[WARN] command wget/curl not found, exit" exit 1; fi; if command -v rpm; then sudo rpm -ivh --force $PACKAGE elif command -v dpkg; then sudo dpkg -i $PACKAGE else echo "[WARN] command rpm/dpkg not found, exit" exit 2; fi if [[ -e /etc/redhat-release ]]; then if sudo systemctl status qemu-guest-agent; then sudo systemctl stop qemu-guest-agent sudo systemctl disable qemu-guest-agent sudo systemctl restart aliyun.service fi fi
FreeBSD
以sudo許可權的使用者遠端連線ECS執行個體。
具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體。
執行如下指令碼,完成雲助手安裝包的下載與安裝。
重要以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中
VERSION=latest
修改為指定的版本號碼,例如VERSION=2.3.3.529
。內網下載安裝指令碼
推薦,適用於ECS執行個體,預設可以通過內網下載。
#!/bin/sh VERSION=latest use_curl=0 which curl >/dev/null 2>&1 && use_curl=1 if [ $use_curl -eq 1 ];then REGION=$(curl http://100.100.100.200/latest/meta-data/region-id) else REGION=$(wget -O - http://100.100.100.200/latest/meta-data/region-id) fi DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com PACKAGE=aliyun_assist_${VERSION}.txz PKG_URI="https://$DOMAIN/freebsd/$PACKAGE" if [ $use_curl -eq 1 ];then curl -o $PACKAGE $PKG_URI else wget -O $PACKAGE $PKG_URI fi pkg install -U -y $PACKAGE service aliyun start
公網下載安裝指令碼
適用於非阿里雲主機以及可出公網的ECS執行個體。
#!/bin/sh VERSION=latest DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com PACKAGE=aliyun_assist_${VERSION}.txz PKG_URI="https://$DOMAIN/freebsd/$PACKAGE" use_curl=0 which curl >/dev/null 2>&1 && use_curl=1 if [ $use_curl -eq 1 ];then curl -o $PACKAGE $PKG_URI else wget -O $PACKAGE $PKG_URI fi pkg install -U -y $PACKAGE service aliyun start
Binary安裝方式
適合主流Linux作業系統。
以sudo許可權的使用者遠端連線ECS執行個體。
具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體。
執行如下指令碼,完成雲助手安裝包的下載與安裝。
重要以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中
VERSION=latest
修改為指定的版本號碼,例如VERSION=2.2.3.398
。內網下載安裝指令碼
推薦,適用於ECS執行個體,預設可以通過內網下載。
#!/bin/bash VERSION=latest PACKAGE= PKG_URI= REGION=$(curl http://100.100.100.200/latest/meta-data/region-id) DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com arch=$(uname -m) echo "[main] arch = ${arch}" case $arch in "i386"|"i686"|"x86_64"|"amd64") PACKAGE="aliyun_assist_${VERSION}_update.zip" PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then curl -o $PACKAGE $PKG_URI else echo "[WARN] command wget/curl not found, exit" exit 1 fi; TARGET_DIR=/usr/local/share/aliyun-assist sudo unzip -o $PACKAGE -d $TARGET_DIR/ TRUE_VERSION=$(cat $TARGET_DIR/version) sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install sudo bash $TARGET_DIR/$TRUE_VERSION/update_install
公網下載安裝指令碼
適用於非阿里雲主機以及可出公網的ECS執行個體。
#!/bin/bash VERSION=latest PACKAGE= PKG_URI= DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com arch=$(uname -m) echo "[main] arch = ${arch}" case $arch in "i386"|"i686"|"x86_64"|"amd64") PACKAGE="aliyun_assist_${VERSION}_update.zip" PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then curl -o $PACKAGE $PKG_URI else echo "[WARN] command wget/curl not found, exit" exit 1 fi; TARGET_DIR=/usr/local/share/aliyun-assist sudo unzip -o $PACKAGE -d $TARGET_DIR/ TRUE_VERSION=$(cat $TARGET_DIR/version) sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install sudo bash $TARGET_DIR/$TRUE_VERSION/update_install
原始碼安裝方式
以sudo許可權的使用者遠端連線ECS執行個體。
具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體。
安裝Git和Go等必要的軟體。
此樣本通過yum安裝,如果您使用其他Linux版本,請修改為對應的包管理工具。
安裝Git:
sudo yum install git -y
安裝Go:
sudo yum install go -y
下載雲助手Agent源碼。
sudo git clone https://github.com/aliyun/aliyun_assist_client
進入源碼存放目錄。
cd ./aliyun_assist_client
編譯源碼。
sudo go build
如果返回結果無報錯資訊,表示安裝成功。
如果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等)為例,回顯如下:
運行雲助手Agent。
aliyun-service -d
通過OpenAPI方式安裝
您還可以通過調用阿里雲的OpenAPI,觸發安裝任務。該安裝方式不區分作業系統類型。
API的調用流程如下:
調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。
若執行個體並未安裝雲助手Agent,則調用InstallCloudAssistant安裝雲助手Agent。
安裝完成之後,調用RebootInstance重啟ECS執行個體。
通過OpenAPI方式安裝時,需配置身份憑據(如AccessKey)資訊。有關如何擷取AccessKey,請參見建立AccessKey。
接下來,我們以通過CLI方式調用API為例,講解安裝過程。
通過阿里雲CLI安裝用戶端,可免除遠端連線執行個體的步驟,請確保您已經為本地用戶端安裝了阿里雲CLI,在不同作業系統中安裝CLI的方式如下:
RHEL不支援通過阿里雲CLI安裝。
調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]
說明請替換命令中的<YOUR-REGION-ID>為您ECS執行個體所在地區,<YOUR-INSTANCE-ID>為您ECS執行個體ID。當查詢多個ECS執行個體是否安裝雲助手Agent時,請在命令中增加
--InstanceId.2 <YOUR-INSTANCE-ID> --InstanceId.3 <YOUR-INSTANCE-ID> ... --InstanceId.N <YOUR-INSTANCE-ID>
。返回
CloudAssistantStatus=true
時,表示ECS執行個體已安裝雲助手Agent。否則,請繼續下一步。調用InstallCloudAssistant安裝雲助手Agent。
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
說明請替換命令中的<YOUR-REGION-ID>為您ECS執行個體所在地區,<YOUR-INSTANCE-ID>為您ECS執行個體ID。當為多個ECS執行個體安裝雲助手Agent時,請在命令中增加
--InstanceId.2 <YOUR-INSTANCE-ID> --InstanceId.3 <YOUR-INSTANCE-ID> ... --InstanceId.N <YOUR-INSTANCE-ID>
。調用RebootInstance重啟ECS執行個體。
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
說明請替換命令中的<YOUR-INSTANCE-ID>為您ECS執行個體ID。
如果ECS執行個體的網路類型為傳統網路,在執行個體內部添加所屬地區聲明。
以root/system許可權遠端連線ECS執行個體。
具體操作,請參見ECS遠端連線方式概述。
查看雲助手版本。
Linux:運行以下命令。
aliyun-service -v
Windows:具體操作,請參見升級、禁止自動升級雲助手Agent。
如果雲助手Agent版本高於1.0.1.400,雲助手Agent安裝成功;否則,繼續下一步操作。
建立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
在雲助手的安裝目錄下,建立名為region-id的檔案(不要添加類似.txt或.conf的副檔名)。
重要Windows系統會隱藏已知檔案類型的副檔名,您必須設定顯示已知檔案類型的副檔名才能真正判斷region-id是否帶有副檔名。
在region-id檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。
說明您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區,然後在地區和可用性區域中查看對應的地區ID。
以Windows Server 2012 R2為例,在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下:
查看ECS執行個體的雲助手Agent資訊
通過控制台查看
您安裝好雲助手Agent後,可以在控制台通過以下步驟查看ECS執行個體的雲助手Agent版本號碼、狀態等資訊。
訪問ECS控制台-雲助手。
在頁面左側頂部,選擇目標資源所在的資源群組和地區。
單擊ECS執行個體頁簽,查看當前地區ECS執行個體上的雲助手Agent資訊。
通過API查看
您也可調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。
登入執行個體查看
Linux
遠端連線ECS執行個體。具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體。
查看雲助手服務狀態。
確定ECS執行個體的初始化系統,依據該初始化系統選擇相應的命令查看雲助手服務狀態。
ls -l /sbin/init
如果輸出指向
/lib/systemd/systemd
,執行如下命令查看雲助手狀態。systemctl status aliyun.service
當雲助手狀態為
active (running)
,說明雲助手服務正常運行中。如果輸出指向
/sbin/upstart
,執行如下命令查看雲助手狀態。/sbin/initctl status aliyun-service
當雲助手狀態為
start/running
,說明雲助手服務正常運行中。如果輸出指向
/sbin/init
,執行如下命令查看雲助手狀態。/etc/init.d/aliyun-service status
當雲助手狀態為
Running
,說明雲助手服務正常運行中。
查看雲助手的版本。
rpm包管理:
sudo rpm -qa | grep aliyun_assist
deb包管理:
sudo dpkg -l | grep aliyun-assist
Windows
遠端連線ECS執行個體,具體操作,請參見通過密碼認證登入Windows執行個體。
查看雲助手服務狀態。
單擊開始菜單,搜尋
。選擇
。找到Aliyun Assist Service,查看Aliyun Assist Service狀態。如果狀態為正在運行,說明雲助手服務正常運行中。
查看雲助手的版本。
雙擊Aliyun Assist Service,在快顯視窗中找到可執行檔的路徑,在路徑中可以查看雲助手的版本。
例如可執行檔的路徑為C:\ProgramData\aliyun\assist\2.1.3.857\aliyun_assist_service.exe,其中2.1.3.857為雲助手的版本。