Untuk menjalankan operasi seperti logon-free management, command execution, atau file transfer melalui konsol atau Application Programming Interface (API), Anda harus menginstal Cloud Assistant Agent pada target instans Elastic Compute Server (ECS).
Catatan penggunaan
Cloud Assistant Agent dapat diinstal pada Operating Systems (OS) berikut:
Linux: Alibaba Cloud Linux, AlmaLinux 8+, Anolis OS 7+, CentOS 5+, Debian 8+, Ubuntu 12+, RHEL 5+, SUSE 11+, Fedora 33+, CoreOS, dan OpenSUSE.
FreeBSD: 11+.
Windows: Server 2012+.
Cloud Assistant Agent telah terinstal secara default pada semua instans ECS yang dibuat dari public image sejak 1 Desember 2017.
Prosedur
Konsol
Di bilah navigasi atas, pilih resource group dan region untuk target resource Anda.
Klik tab ECS Instances untuk melihat status Cloud Assistant pada instans ECS di region yang dipilih.
Normal: Agent telah terinstal.
Belum diinstal: Klik Install. Setelah instalasi selesai, Anda mungkin perlu me-restart instans dan memverifikasi bahwa status berubah menjadi Normal.

Abnormal: Lihat Menangani exceptions untuk Cloud Assistant.
Pada instans Linux
Langkah 1: Periksa apakah Cloud Assistant Agent sudah terinstal
Identifikasi jenis sistem init.
Sistem init bertanggung jawab untuk memuat dan mengelola proses service saat startup sistem. Perintah untuk Cloud Assistant Agent bervariasi tergantung pada sistem init.
systemd: Alibaba Cloud Linux, CentOS 7+, RHEL 7+, Fedora 15+, Ubuntu 15.04+, Debian 8+, dan lainnya.Upstart: Ubuntu 6.10-14.10, RHEL 6, CentOS 6, dan lainnya.SysVinit: RHEL 5, CentOS 5, Debian 6, dan lainnya.
Verifikasi instalasi agent.
systemd
systemctl status aliyun.serviceJika output berisi
Unit aliyun.service tidak ditemukan, agent belum terinstal.upstart
/sbin/initctl status aliyun-serviceJika output berisi
initctl: Pekerjaan Tidak Dikenal: aliyun-service, agent belum terinstal.sysvinit
/etc/init.d/aliyun-service statusJika output kosong, agent belum terinstal.
Langkah 2: Unduh dan instal Cloud Assistant Agent
Skrip ini akan menginstal agent versi terbaru secara default. Untuk menginstal versi tertentu, modifikasi 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
Pada instans Windows
Langkah 1: Periksa apakah Cloud Assistant Agent sudah terinstal
Periksa status service Cloud Assistant.
Klik menu Start, lalu cari .
Pilih .
Cari Aliyun Assist Service. Jika service tidak terdaftar, agent belum terinstal.

Langkah 2: Unduh dan instal Cloud Assistant Agent
Metode 1: Unduh melalui browser
Unduh Cloud Assistant Agent.
Ganti
{regionId}pada URL dengan region ID instans Anda, lalu buka alamat tersebut di browser.https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe # Contoh: URL unduhan untuk wilayah China (Hangzhou) (cn-hangzhou) https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exeInstal Cloud Assistant Agent.
Klik dua kali file agent dan ikuti panduan instalasi. Jalur instalasi default adalah
C:\ProgramData\aliyun\assist\.
Metode 2: Instal menggunakan PowerShell
Ganti {regionId} dalam skrip dengan region ID instans Anda, lalu jalankan skrip tersebut di 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
Prosedur instalasi ini berlaku untuk semua OS.
Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada instans ECS target.
Jika
CloudAssistantStatusbernilaifalse, agent belum terinstal.Jika agent belum terinstal, panggil operasi InstallCloudAssistant untuk menginstalnya.
Setelah instalasi selesai, panggil operasi RebootInstance untuk me-restart instans ECS.
CLI
Gunakan Alibaba Cloud CLI untuk menginstal Cloud Assistant Agent. Prosedurnya sama untuk semua OS. Ganti <YOUR-REGION-ID> dengan region ID instans ECS Anda dan <YOUR-INSTANCE-ID> dengan ID instans Anda.
Red Hat Enterprise Linux (RHEL) tidak mendukung instalasi melalui Alibaba Cloud CLI.
Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada target instans ECS.
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]Jika output perintah menunjukkan
CloudAssistantStatus=true, Cloud Assistant Agent sudah terinstal.Panggil operasi InstallCloudAssistant untuk menginstal Cloud Assistant Agent.
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>Panggil operasi RebootInstance untuk me-restart instans ECS.
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
FAQ
Apa yang dapat saya lakukan jika OS saya tidak mendukung Cloud Assistant Agent?
Migrasikan OS: Upgrade atau migrasikan sistem saat ini ke versi yang didukung.
Ganti OS (disk sistem): Instal OS yang didukung pada instans dengan mengganti disk sistemnya.
Mengapa saya tidak dapat menginstal versi terbaru Cloud Assistant Agent meskipun sistem operasi saya didukung?
Beberapa versi kernel membatasi versi agent yang dapat diinstal.
Jalankan uname -r untuk memeriksa versi kernel Anda.Versi kernel instance | Versi terbaru Agen Asisten Cloud yang tersedia |
Versi kernel Linux < 2.6.32 |
|
Versi kernel FreeBSD < 12.x | 2.3.3.529 |
Bagaimana cara menginstal Cloud Assistant Agent di OS FreeBSD?
Untuk instans ECS Alibaba Cloud
#!/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 startUntuk managed instans (server non-Alibaba Cloud)
#!/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
Bagaimana cara menginstal Cloud Assistant Agent pada managed instans (server non-Alibaba Cloud)?
Linux
Skrip ini akan menginstal agent versi terbaru secara default. Untuk menginstal versi tertentu, modifikasi 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
Metode 1: Unduh melalui browser.
Buka URL berikut di browser untuk mengunduh Cloud Assistant Agent.
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exeInstal Cloud Assistant Agent
Klik dua kali file agent dan ikuti panduan instalasi. Jalur instalasi default adalah
C:\ProgramData\aliyun\assist\.
Metode 2: Instal menggunakan PowerShell
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' Bagaimana cara menginstal Cloud Assistant Agent dari paket biner atau kode sumber?
Instal dari paket biner
Untuk instans ECS Alibaba Cloud
Secara default, skrip ini akan menginstal agent versi terbaru. Untuk menginstal versi tertentu, modifikasi
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_installUntuk managed instans (server non-Alibaba Cloud)
#!/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
Instal dari kode sumber
Contoh ini menggunakan yum untuk instalasi. Jika Anda menggunakan distribusi Linux lain, gunakan manajer paket yang sesuai.
Instal Git dan Go.
# Instal Git sudo yum install git -y # Instal Go sudo yum install go -yUnduh kode sumber Cloud Assistant Agent.
sudo git clone https://github.com/aliyun/aliyun_assist_clientNavigasi ke direktori kode sumber dan kompilasi kode.
# Pergi ke direktori kode sumber cd ./aliyun_assist_client # Kompilasi kode sumber sudo go buildJika perintah berjalan tanpa kesalahan, instalasi berhasil.
Mengapa Cloud Assistant Agent tidak berfungsi setelah diinstal pada instans di classic network?
Pada instans ECS di classic network, Cloud Assistant Agent tidak dapat memperoleh informasi region secara otomatis. Anda harus mengonfigurasi region secara manual dengan membuat file konfigurasi di instans.
Classic network adalah jenis jaringan lama dari Alibaba Cloud yang tidak lagi tersedia untuk pembelian. Disarankan untuk memigrasikan instans Anda ke Virtual Private Cloud (VPC) untuk performa dan keamanan yang lebih baik.
Linux
Di direktori instalasi agent, buat file bernama
region-idyang berisi region ID dari instans ECS.Sebagai contoh, untuk wilayah China (Hangzhou), buat file
region-iddi direktori instalasi default.CoreOS:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'OS lain (seperti Alibaba Cloud Linux, Ubuntu, Debian, RedHat, SUSE Linux Enterprise Server, dan OpenSUSE):
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
Jalankan Cloud Assistant Agent.
aliyun-service -d
Windows
Di direktori instalasi agent, buat file bernama region-id, tanpa menambahkan ekstensi seperti .txt atau .conf.
Windows secara default menyembunyikan ekstensi file untuk known file types. Anda mungkin perlu mengubah pengaturan untuk menampilkan ekstensi file agar memastikan file region-id tidak memiliki ekstensi.
Masukkan region ID dari instans ECS, seperti cn-hangzhou, ke dalam file region-id.
Contoh: Gambar berikut menunjukkan file region-id untuk wilayah cn-hangzhou, yang terletak di jalur instalasi default C:\ProgramData\aliyun\assist\ pada instance Windows Server 2012 R2.