需要通過控制台或API進行免登入管理、執行命令或者傳送檔案等操作時,必須在目標執行個體上安裝並運行雲助手Agent。
適用範圍
以下作業系統支援安裝雲助手Agent:
Linux:Alibaba Cloud Linux、AlmaLinux 8+、Anolis OS 7+、CentOS 5+、Debian 8+、Ubuntu 12+、RHEL 5+、SUSE 11+、Fedora 33+、CoreOS、OpenSUSE。
FreeBSD:11+。
Windows:Server 2012+。
自2017年12月1日起,通過公用鏡像建立的ECS執行個體已預裝雲助手Agent。
操作步驟
控制台
訪問ECS控制台-雲助手。
在頁面左側頂部,選擇目標資源所在的資源群組和地區。
單擊ECS執行個體頁簽,查看當前地區ECS執行個體上的雲助手狀態。
正常:已安裝。
未安裝:單擊一鍵安裝,等待安裝完成,需要重啟執行個體之後查看狀態是否變為正常。

異常:請參見雲助手異常狀態處理。
Linux執行個體
步驟一:檢查是否已安裝雲助手Agent
判斷初始化系統類別型。
初始化系統(init system)負責在系統啟動時載入和管理服務進程,不同初始化系統對應的雲助手Agent的命令不同。
systemd:Alibaba Cloud Linux、CentOS 7+、RHEL 7+、Fedora 15+、Ubuntu 15.04+、Debian 8+等。Upstart:Ubuntu 6.10-14.10、RHEL 6、CentOS 6等。SysVinit:RHEL 5、CentOS 5、Debian 6等。
驗證是否安裝雲助手Agent。
systemd
systemctl status aliyun.service若回執資訊包含
Unit aliyun.service could not be found提示,表示未安裝。upstart
/sbin/initctl status aliyun-service若回執資訊包含
initctl: Unknown job: aliyun-service提示,表示未安裝。sysvinit
/etc/init.d/aliyun-service status若回執資訊為空白,表示未安裝。
步驟二:下載並安裝雲助手Agent
指令碼適用於阿里雲ECS執行個體,預設安裝最新版本的Agent,安裝指定版本請修改VERSION=latest。
#!/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
Windows執行個體
步驟一:檢查是否已安裝雲助手Agent
查看雲助手服務狀態。
單擊開始菜單,搜尋。
選擇。
尋找Aliyun Assist Service,若不存在,表示未安裝。

步驟二:下載並安裝雲助手Agent
方法一:通過瀏覽器下載雲助手Agent
下載雲助手Agent。
將地址中的
{regionId}替換為執行個體所在地區ID後,在瀏覽器中開啟。https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe # 樣本:杭州(cn-hangzhou)下載地址 https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe安裝雲助手Agent。
雙擊雲助手Agent檔案,根據安裝嚮導完成安裝。預設安裝路徑為
C:\ProgramData\aliyun\assist\。
方法二:通過PowerShell安裝並啟動雲助手Agent
將指令碼中的{regionId}替換為執行個體所在地區ID後,在PowerShell中執行。
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' API
通過API安裝雲助手Agent不區分作業系統類型。
調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。
CloudAssistantStatus返回false時,表示未安裝。若執行個體未安裝雲助手Agent,則調用InstallCloudAssistant安裝雲助手Agent。
安裝完成之後,調用RebootInstance重啟ECS執行個體使安裝生效。
CLI
通過阿里雲CLI安裝雲助手Agent不區分作業系統類型。請替換命令中的<YOUR-REGION-ID>為ECS執行個體所在地區ID,<YOUR-INSTANCE-ID>為ECS執行個體ID。
Red Hat Enterprise Linux (RHEL) 不支援通過阿里雲CLI安裝。
調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent。
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]返回
CloudAssistantStatus=true時,表示ECS執行個體已安裝雲助手Agent。調用InstallCloudAssistant安裝雲助手Agent。
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>調用RebootInstance重啟ECS執行個體。
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
常見問題
如果我的作業系統不支援安裝雲助手Agent,該怎麼辦?
遷移作業系統: 將當前系統升級或遷移到受支援的版本。
更換作業系統(更換系統硬碟): 通過更換系統硬碟功能,為執行個體安裝一個受支援的作業系統。
為什麼作業系統支援但無法安裝最新版本的雲助手Agent?
部分核心在安裝雲助手時存在最高可安裝版本的限制。
執行uname -r查看核心版本。執行個體的核心版本號碼 | 雲助手Agent可升級的最高版本 |
Linux核心版本 < 2.6.32 |
|
FreeBSD 核心版本 < 12.x | 2.3.3.529 |
FreeBSD作業系統如何安裝雲助手Agent?
適用於阿里雲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適用於受管理的執行個體(非阿里雲伺服器)
#!/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
受管理的執行個體(非阿里雲伺服器)如何安裝雲助手Agent?
Linux
指令碼預設安裝最新版本的Agent,安裝指定版本請修改VERSION=latest。#!/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
fiWindows
方法一:通過瀏覽器開啟網址下載雲助手Agent。
在瀏覽器中開啟網址下載雲助手Agent。
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe安裝雲助手Agent。
雙擊雲助手Agent檔案,根據安裝嚮導完成安裝。預設安裝路徑為
C:\ProgramData\aliyun\assist\。
方法二:通過PowerShell安裝並啟動雲助手Agent
curl -UseBasicParsing -Uri https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
;"C:\\aliyun_agent_latest_setup.exe" '/S' 雲助手Agent如何通過二進位包或者源碼等方式安裝?
二進位包(Binary)安裝
適用於阿里雲ECS執行個體
指令碼預設安裝最新版本的Agent,安裝指定版本請修改
VERSION=latest。#!/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適用於受管理的執行個體(非阿里雲伺服器)
#!/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
源碼安裝
樣本通過yum安裝,如果使用其他Linux版本,請修改為對應的包管理工具。
安裝Git和Go等必要的軟體。
# 安裝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如果返回結果無報錯資訊,表示安裝成功。
傳統網路執行個體安裝了雲助手Agent之後為什麼無法使用?
對於傳統網路的ECS執行個體,雲助手Agent無法自動擷取地區資訊,需要手動設定,在執行個體內部添加所屬地區聲明。
傳統網路是阿里雲早期提供的網路類型,現已停止售賣,建議遷移到專用網路以獲得更優的效能和安全性。
Linux
在雲助手的安裝目錄下,建立名為region-id的檔案,並在檔案中填入ECS執行個體所屬地區的ID。
以杭州地區為例,在預設安裝目錄
/opt/local/share/aliyun-assist/下建立region-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'
運行雲助手Agent。
aliyun-service -d
Windows
在雲助手的安裝目錄下,建立名為region-id的檔案(不要添加類似.txt或.conf的副檔名)。
Windows系統預設隱藏已知檔案類型的副檔名,需設定顯示已知檔案類型的副檔名以確認region-id檔案是否帶有副檔名。
在region-id檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou。
樣本:以Windows Server 2012 R2為例,在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的結果如下: