All Products
Search
Document Center

Elastic Compute Service:Instal Cloud Assistant Agent

Last Updated:May 16, 2026

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

  1. Buka halaman ECS console - Cloud Assistant.

  2. Di pojok kiri atas, pilih wilayah dan resource group untuk instance target.

  3. 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.

      image.png

    • Abnormal: Lihat Handle exceptions for Cloud Assistant.

Instance Linux

Periksa instalasi agen

  1. Masuk ke instance Linux menggunakan Workbench.

  2. 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.

  3. Verifikasi bahwa Cloud Assistant Agent telah terinstal.

    Systemd

    systemctl status aliyun.service

    Jika output berisi Unit aliyun.service could not be found, agen belum terinstal.

    Upstart

    /sbin/initctl status aliyun-service

    Jika output berisi initctl: Unknown job: aliyun-service, agen belum terinstal.

    Sysvinit

    /etc/init.d/aliyun-service status

    Jika 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

  1. Terhubung ke instance Windows menggunakan client Remote Desktop atau Windows App.

  2. Periksa status layanan Cloud Assistant.

    1. Buka menu Start dan cari Computer Management.

    2. Navigasi ke Services and Applications > Services.

    3. Cari Aliyun Assist Service. Jika tidak terdaftar, agen belum terinstal.

      image

Unduh dan instal agen

Metode 1: Unduh menggunakan browser
  1. 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
  2. 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.

  1. Panggil DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada instance target.

    Jika CloudAssistantStatus bernilai false, agen belum terinstal.

  2. Jika agen belum terinstal, panggil InstallCloudAssistant untuk menginstalnya.

  3. 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).
  1. 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.

  2. Panggil InstallCloudAssistant untuk menginstal agen.

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. Panggil RebootInstance untuk me-restart instance tersebut.

    aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>

FAQ

Sistem operasi yang tidak 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

  • Arsitektur x86/x64: 2.2.3.398

  • Arsitektur Arm: 2.4.3.398

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
  1. Buka URL berikut di browser untuk mengunduh Cloud Assistant Agent.

    https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. 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.

  1. Instal perangkat lunak yang diperlukan, seperti Git dan Go.

    # Instal Git
    sudo yum install git -y
    
    # Instal Go
    sudo yum install go -y
  2. Unduh kode sumber Cloud Assistant Agent.

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. Masuk ke direktori kode sumber dan kompilasi.

    # Masuk ke direktori kode sumber
    cd ./aliyun_assist_client
    
    # Kompilasi kode sumber
    sudo go build

    Jika 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

  1. Di direktori instalasi agen, buat file bernama region-id yang berisi region ID dari instance ECS tersebut.

    Sebagai contoh, untuk instance di wilayah China (Hangzhou), buat file region-id di 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'
  2. Jalankan Cloud Assistant Agent.

    aliyun-service -d

Windows

  1. 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.
  2. 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\.Add region-id file on Windows