Instal dan mulai Cloud Assistant Agent pada instance ECS Anda untuk menjalankan perintah dan mengirim file secara remote.
Cakupan
Cloud Assistant Agent mendukung sistem operasi 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+.
Sejak 1 Desember 2017, semua instance ECS yang dibuat dari public image telah memiliki Cloud Assistant Agent yang pra-instal.
Prosedur
Konsol
-
Buka halaman ECS console - Cloud Assistant.
-
Di pojok kiri atas, pilih wilayah dan resource group untuk instance target.
-
Klik tab ECS Instances untuk melihat status Cloud Assistant Agent pada instance di wilayah saat ini.
-
Normal: Agen telah terinstal.
-
Not Installed: Klik Install dan tunggu hingga instalasi selesai. Restart instance tersebut dan periksa apakah statusnya berubah menjadi Normal.

-
Abnormal: Lihat Handle exceptions for Cloud Assistant.
-
Instance Linux
Periksa instalasi agen
-
Identifikasi jenis sistem init.
Sistem init mengelola proses layanan saat startup. Perintah Cloud Assistant Agent berbeda-beda 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 bahwa Cloud Assistant Agent telah terinstal.
Systemd
systemctl status aliyun.serviceJika output berisi
Unit aliyun.service could not be found, agen belum terinstal.Upstart
/sbin/initctl status aliyun-serviceJika output berisi
initctl: Unknown job: aliyun-service, agen belum terinstal.Sysvinit
/etc/init.d/aliyun-service statusJika output kosong, agen belum terinstal.
Unduh dan instal agen
Skrip ini ditujukan untuk instance ECS Alibaba Cloud dan secara default menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah baris 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
Instance Windows
Periksa instalasi agen
-
Terhubung ke instance Windows menggunakan client Remote Desktop atau Windows App.
-
Periksa status layanan Cloud Assistant.
-
Buka menu Start dan cari .
-
Navigasi ke .
-
Cari Aliyun Assist Service. Jika tidak terdaftar, agen belum terinstal.

-
Unduh dan instal agen
Metode 1: Unduh menggunakan browser
-
Unduh Cloud Assistant Agent.
Ganti
{regionId}dengan region ID instance Anda dan buka URL 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.exe -
Instal Cloud Assistant Agent.
Klik ganda file agen tersebut dan ikuti panduan instalasi. Jalur default:
C:\ProgramData\aliyun\assist\.
Metode 2: Instal menggunakan PowerShell
Ganti {regionId} dengan region ID instance Anda, lalu jalankan skrip berikut 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
Berlaku untuk semua sistem operasi yang didukung.
-
Panggil DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada instance target.
Jika
CloudAssistantStatusbernilaifalse, agen belum terinstal. -
Jika agen belum terinstal, panggil InstallCloudAssistant untuk menginstalnya.
-
Setelah instalasi, panggil RebootInstance untuk me-restart instance tersebut.
CLI
Menggunakan Alibaba Cloud CLI. Berlaku untuk semua sistem operasi yang didukung. Ganti <YOUR-REGION-ID> dengan region ID instance ECS Anda dan <YOUR-INSTANCE-ID> dengan ID instans tersebut.
Instalasi Alibaba Cloud CLI tidak didukung pada Red Hat Enterprise Linux (RHEL).
-
Panggil DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada instance target.
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]Jika perintah mengembalikan
CloudAssistantStatus=true, agen telah terinstal. -
Panggil InstallCloudAssistant untuk menginstal agen.
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> -
Panggil RebootInstance untuk me-restart instance tersebut.
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
FAQ
Sistem operasi yang tidak didukung
-
Migrate the OS: Tingkatkan atau migrasikan ke versi yang didukung.
-
Replace the OS (system disk): Ganti disk sistem dengan sistem operasi yang didukung.
Tidak dapat menginstal versi terbaru
Beberapa kernel membatasi versi agen yang dapat Anda instal.
Jalankan uname -r untuk memeriksa versi kernel Anda.
|
Versi kernel instance |
Versi terbaru yang didukung |
|
Versi kernel Linux < 2.6.32 |
|
|
Versi kernel FreeBSD < 12.x |
2.3.3.529 |
Instalasi pada FreeBSD
-
Untuk instance 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 start -
Untuk managed instance (server yang tidak di-hosting di 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
Instalasi pada managed instance
Linux
Secara default menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah baris 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
fi
Windows
Metode 1: Unduh menggunakan browser
-
Buka URL berikut di browser untuk mengunduh Cloud Assistant Agent.
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -
Instal Cloud Assistant Agent.
Klik ganda file agen tersebut dan ikuti panduan instalasi. Jalur default:
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
Instal dari binary atau source
Paket binary
-
Untuk instance ECS Alibaba Cloud
Secara default menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah baris
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 -
Untuk managed instance (server yang tidak di-hosting di 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
Kode sumber
Contoh berikut menggunakan yum. Untuk distribusi lain, gunakan package manager yang sesuai.
-
Instal perangkat lunak yang diperlukan, seperti Git dan Go.
# Instal Git sudo yum install git -y # Instal Go sudo yum install go -y -
Unduh kode sumber Cloud Assistant Agent.
sudo git clone https://github.com/aliyun/aliyun_assist_client -
Masuk ke direktori kode sumber dan kompilasi.
# Masuk ke direktori kode sumber cd ./aliyun_assist_client # Kompilasi kode sumber sudo go buildJika perintah dijalankan tanpa error, instalasi berhasil.
Permasalahan agen pada jaringan klasik
Untuk instance ECS dalam jaringan klasik, Cloud Assistant Agent tidak dapat memperoleh informasi wilayah secara otomatis. Anda harus membuat file konfigurasi wilayah secara manual pada instance tersebut.
Jaringan klasik adalah jenis jaringan lawas yang tidak lagi tersedia untuk pembelian baru. Kami menyarankan Anda untuk migrasi ke VPC demi performa dan keamanan yang lebih baik.
Linux
-
Di direktori instalasi agen, buat file bernama
region-idyang berisi region ID dari instance ECS tersebut.Sebagai contoh, untuk instance di wilayah China (Hangzhou), buat file
region-iddi direktori default/usr/local/share/aliyun-assist/.-
Untuk CoreOS:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id' -
Untuk sistem operasi lain (seperti Alibaba Cloud Linux, Ubuntu, Debian, RedHat, SUSE, 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 agen, buat file bernama region-id (tanpa ekstensi seperti .txt atau .conf).
Secara default, Windows menyembunyikan ekstensi file. Konfigurasikan sistem Anda agar menampilkan ekstensi untuk memastikan file region-id tidak memiliki ekstensi.
-
Di file region-id, masukkan region ID instance tersebut, misalnya cn-hangzhou.
Contoh: Untuk instance Windows Server 2012 R2 di China (Hangzhou), buat file region-id yang berisi cn-hangzhou di C:\ProgramData\aliyun\assist\.