全部产品
Search
文档中心

Elastic Compute Service:Instal Agen Asisten Cloud

更新时间:Nov 22, 2025

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

  1. Buka ECS console - Cloud Assistant.

  2. Di bilah navigasi atas, pilih resource group dan region untuk target resource Anda.

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

      image.png

    • Abnormal: Lihat Menangani exceptions untuk Cloud Assistant.

Pada instans Linux

Langkah 1: Periksa apakah Cloud Assistant Agent sudah terinstal

  1. Masuk ke instans Linux menggunakan Workbench.

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

  3. Verifikasi instalasi agent.

    systemd

    systemctl status aliyun.service

    Jika output berisi Unit aliyun.service tidak ditemukan, agent belum terinstal.

    upstart

    /sbin/initctl status aliyun-service

    Jika output berisi initctl: Pekerjaan Tidak Dikenal: aliyun-service, agent belum terinstal.

    sysvinit

    /etc/init.d/aliyun-service status

    Jika 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

  1. Masuk ke instans Windows menggunakan kata sandi.

  2. Periksa status service Cloud Assistant.

    1. Klik menu Start, lalu cari Computer Management.

    2. Pilih Services and Applications > Services.

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

      image

Langkah 2: Unduh dan instal Cloud Assistant Agent

Metode 1: Unduh melalui browser
  1. 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.exe
  2. Instal 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.

  1. Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah Cloud Assistant Agent telah terinstal pada instans ECS target.

    Jika CloudAssistantStatus bernilai false, agent belum terinstal.

  2. Jika agent belum terinstal, panggil operasi InstallCloudAssistant untuk menginstalnya.

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

  2. Panggil operasi InstallCloudAssistant untuk menginstal Cloud Assistant Agent.

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. 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?

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

  • Arsitektur X86/X64: 2.2.3.398

  • Arsitektur ARM: 2.4.3.398

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 start
  • Untuk 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
fi

Windows

Metode 1: Unduh melalui 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 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_install
  • Untuk 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.

  1. Instal 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. Navigasi ke direktori kode sumber dan kompilasi kode.

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

    Jika 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

  1. Di direktori instalasi agent, buat file bernama region-id yang berisi region ID dari instans ECS.

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

    aliyun-service -d

Windows

  1. 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.
  2. 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.Menambahkan file di Windows