Untuk mengelola instans Anda tanpa login, menjalankan perintah, atau mengirim file melalui Konsol atau API, Anda harus menginstal dan menjalankan agen Cloud Assistant pada instans target.
Keberlakuan
Agen Cloud Assistant didukung pada 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: Windows Server 2012+.
Alibaba Cloud telah memprainstal agen Cloud Assistant pada Instance ECS yang dibuat dari gambar publik setelah 1 Desember 2017.
Prosedur
Konsol
Buka halaman ECS console - Cloud Assistant.
Di pojok kiri atas halaman, pilih kelompok sumber daya dan wilayah dari sumber daya target.
Klik tab ECS Instance untuk melihat status Cloud Assistant pada Instance ECS di wilayah saat ini.
Normal: Agen telah terinstal.
Not Installed: Klik Install dan tunggu hingga instalasi selesai. Restart instans, lalu periksa apakah statusnya berubah menjadi Normal.
Abnormal: Untuk informasi lebih lanjut, lihat Tangani pengecualian untuk Cloud Assistant.
Instans Linux
Langkah 1: Periksa instalasi agen
Identifikasi jenis sistem init.
Sistem init memuat dan mengelola proses layanan saat startup. Perintah agen Cloud Assistant bervariasi tergantung pada sistem init.
systemd: Alibaba Cloud Linux, CentOS 7+, RHEL 7+, Fedora 15+, Ubuntu 15.04+, Debian 8+, dan distribusi serupa lainnya.Upstart: Ubuntu 6.10 hingga 14.10, RHEL 6, CentOS 6, dan distribusi serupa lainnya.SysVinit: RHEL 5, CentOS 5, Debian 6, dan distribusi serupa lainnya.
Verifikasi bahwa agen Cloud Assistant telah terinstal.
systemd
systemctl status aliyun.serviceJika output berisi pesan
Unit aliyun.service could not be found, berarti agen belum terinstal.Upstart
/sbin/initctl status aliyun-serviceJika output berisi pesan
initctl: Unknown job: aliyun-service, berarti agen belum terinstal.SysVinit
/etc/init.d/aliyun-service statusJika output kosong, berarti agen belum terinstal.
Langkah 2: Unduh dan instal agen
Skrip ini ditujukan untuk Instance ECS Alibaba Cloud. Secara default, skrip ini menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah VERSION=latest.
#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=
REGION=$(curl -s 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}"
# Detect whether the system is openSUSE or SLES.
is_suse_like() {
if [[ -f /etc/os-release ]]; then
local os_id
os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
local os_version
os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
return 0
fi
fi
return 1
}
case $arch in
"i386"|"i686"|"x86_64"|"amd64")
if command -v rpm && ! command -v dpkg; then
if [[ "$arch" == "x86_64" ]] && is_suse_like; then
PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
else
PACKAGE="aliyun_assist_${VERSION}.rpm"
fi
else
if [[ "$arch" == "x86_64" ]] && is_suse_like; then
PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
else
PACKAGE="aliyun_assist_${VERSION}.deb"
fi
fi
PKG_URI="https://$DOMAIN/linux/$PACKAGE"
;;
*)
if command -v rpm && ! command -v dpkg; then
PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
else
PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
fi
PKG_URI="https://$DOMAIN/arm/$PACKAGE"
;;
esac
echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"
if command -v wget; then
sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
echo "[WARN] command wget/curl not found, exit"
exit 1
fi
if command -v rpm && ! command -v dpkg; 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
fiInstans Windows
Langkah 1: Periksa instalasi agen
Hubungkan ke instans Windows menggunakan klien Remote Desktop atau aplikasi Windows.
Periksa status layanan Cloud Assistant.
Buka menu Start dan cari .
Navigasi ke .
Cari Aliyun Assist Service. Jika tidak terdaftar, berarti agen belum terinstal.
Jika layanan tersebut ada dan statusnya Running dengan tipe startup diatur ke Automatic, berarti agen Cloud Assistant telah terinstal dan berjalan dengan baik.
Langkah 2: Unduh dan instal agen
Metode 1: Unduh melalui browser
Unduh agen Cloud Assistant.
Ganti
{regionId}dengan ID wilayah instans Anda, lalu 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.exeInstal agen Cloud Assistant.
Klik ganda file agen Cloud Assistant dan ikuti panduan instalasi. Jalur instalasi default adalah
C:\ProgramData\aliyun\assist\.
Metode 2: Gunakan PowerShell
Ganti {regionId} dengan ID wilayah instans Anda, lalu jalankan perintah 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" /SAPI
Proses instalasi melalui API sama untuk semua sistem operasi yang didukung.
Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah agen Cloud Assistant telah terinstal pada Instance ECS target.
Jika parameter
CloudAssistantStatusmengembalikan nilaifalse, berarti agen belum terinstal.Jika agen belum terinstal, panggil operasi InstallCloudAssistant untuk menginstal agen Cloud Assistant.
Setelah instalasi selesai, panggil operasi RebootInstance untuk me-restart Instance ECS agar perubahan diterapkan.
CLI
Anda dapat menggunakan Alibaba Cloud CLI untuk menginstal agen Cloud Assistant pada sebagian besar sistem operasi yang didukung. Ganti <YOUR-REGION-ID> dengan ID wilayah Instance ECS Anda dan <YOUR-INSTANCE-ID> dengan ID Instance ECS Anda.
Red Hat Enterprise Linux (RHEL) tidak mendukung instalasi menggunakan Alibaba Cloud CLI.
Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah agen Cloud Assistant telah terinstal pada Instance ECS target.
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]Jika perintah mengembalikan
CloudAssistantStatus=true, berarti agen Cloud Assistant telah terinstal pada Instance ECS.Panggil operasi InstallCloudAssistant untuk menginstal agen Cloud Assistant.
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>Panggil operasi RebootInstance untuk me-restart Instance ECS.
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
FAQ
Sistem operasi yang tidak didukung
Migrasikan OS: Tingkatkan atau migrasikan sistem Anda saat ini ke versi yang didukung.
Ganti OS (ganti disk sistem): Gunakan fitur Ganti OS untuk menginstal sistem operasi yang didukung pada instans.
Batasan instalasi versi terbaru
Beberapa kernel membatasi versi agen tertinggi yang dapat Anda instal.
Jalankan perintah uname -r untuk memeriksa versi kernel.Versi kernel instans | Versi tertinggi yang didukung |
Versi kernel Linux < 2.6.32 |
|
Versi kernel FreeBSD < 12.x | 2.3.3.529 |
Instalasi 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 startUntuk instans terkelola (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
Instalasi instans terkelola
Linux
Skrip ini secara default menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah VERSION=latest.#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=
DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
arch=$(uname -m)
echo "[main] arch = ${arch}"
# Detect whether the system is openSUSE or SLES.
is_suse_like() {
if [[ -f /etc/os-release ]]; then
local os_id
os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
local os_version
os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
return 0
fi
fi
return 1
}
case $arch in
"i386"|"i686"|"x86_64"|"amd64")
if command -v rpm && ! command -v dpkg; then
if [[ "$arch" == "x86_64" ]] && is_suse_like; then
PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
else
PACKAGE="aliyun_assist_${VERSION}.rpm"
fi
else
if [[ "$arch" == "x86_64" ]] && is_suse_like; then
PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
else
PACKAGE="aliyun_assist_${VERSION}.deb"
fi
fi
PKG_URI="https://$DOMAIN/linux/$PACKAGE"
;;
*)
if command -v rpm && ! command -v dpkg; then
PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
else
PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
fi
PKG_URI="https://$DOMAIN/arm/$PACKAGE"
;;
esac
echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"
if command -v wget; then
sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
echo "[WARN] command wget/curl not found, exit"
exit 1
fi
if command -v rpm && ! command -v dpkg; 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 agen Cloud Assistant.
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exeInstal agen Cloud Assistant.
Klik ganda file agen Cloud Assistant dan ikuti panduan instalasi. Jalur instalasi default adalah
C:\ProgramData\aliyun\assist\.
Metode 2: Gunakan 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 paket biner atau kode sumber
Paket biner
Untuk Instance ECS Alibaba Cloud
Skrip ini secara default menginstal versi agen terbaru. Untuk menginstal versi tertentu, ubah
VERSION=latest.#!/bin/bash VERSION=latest PACKAGE= PKG_URI= REGION=$(curl -s 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}" # Detect whether the system is openSUSE or SLES. is_suse_like() { if [[ -f /etc/os-release ]]; then local os_id os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2) local os_version os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1) if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then return 0 fi fi return 1 } case $arch in "i386"|"i686"|"x86_64"|"amd64") if [[ "$arch" == "x86_64" ]] && is_suse_like; then PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip" else PACKAGE="aliyun_assist_${VERSION}_update.zip" fi PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" ;; esac echo "[main] package = ${PACKAGE}" echo "[main] pkg_uri = ${PKG_URI}" if command -v wget; then sudo wget -O "${PACKAGE}" "${PKG_URI}" elif command -v curl; then sudo 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 instans terkelola (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}" # Detect whether the system is openSUSE or SLES. is_suse_like() { if [[ -f /etc/os-release ]]; then local os_id os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2) local os_version os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1) if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then return 0 fi fi return 1 } case $arch in "i386"|"i686"|"x86_64"|"amd64") if [[ "$arch" == "x86_64" ]] && is_suse_like; then PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip" else PACKAGE="aliyun_assist_${VERSION}_update.zip" fi PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" ;; esac echo "[main] package = ${PACKAGE}" echo "[main] pkg_uri = ${PKG_URI}" if command -v wget; then sudo wget -O "${PACKAGE}" "${PKG_URI}" elif command -v curl; then sudo 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 Linux lainnya, gunakan manajer paket yang sesuai.
Instal prasyarat, seperti Git dan Go.
# Install Git sudo yum install git -y # Install Go sudo yum install go -yUnduh kode sumber agen Cloud Assistant.
sudo git clone https://github.com/aliyun/aliyun_assist_clientNavigasi ke direktori kode sumber dan kompilasi kode sumber tersebut.
# Go to the source code directory. cd ./aliyun_assist_client # Compile the source code. sudo go buildJika respons tidak berisi pesan error, instalasi berhasil.