All Products
Search
Document Center

Elastic Compute Service:Instal agen Cloud Assistant

Last Updated:Aug 21, 2026

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

  1. Buka halaman ECS console - Cloud Assistant.

  2. Di pojok kiri atas halaman, pilih kelompok sumber daya dan wilayah dari sumber daya target.

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

  1. Hubungkan ke instans Linux menggunakan Workbench.

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

  3. Verifikasi bahwa agen Cloud Assistant telah terinstal.

    systemd

    systemctl status aliyun.service

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

    Upstart

    /sbin/initctl status aliyun-service

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

    SysVinit

    /etc/init.d/aliyun-service status

    Jika 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
fi

Instans Windows

Langkah 1: Periksa instalasi agen

  1. Hubungkan ke instans Windows menggunakan klien Remote Desktop atau aplikasi Windows.

  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, 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
  1. 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.exe
  2. Instal 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" /S

API

Proses instalasi melalui API sama untuk semua sistem operasi yang didukung.

  1. Panggil operasi DescribeCloudAssistantStatus untuk memeriksa apakah agen Cloud Assistant telah terinstal pada Instance ECS target.

    Jika parameter CloudAssistantStatus mengembalikan nilai false, berarti agen belum terinstal.

  2. Jika agen belum terinstal, panggil operasi InstallCloudAssistant untuk menginstal agen Cloud Assistant.

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

  2. Panggil operasi InstallCloudAssistant untuk menginstal agen Cloud Assistant.

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

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

FAQ

Sistem operasi yang tidak didukung

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

  • arsitektur x86/x64: 2.2.3.398

  • arsitektur ARM: 2.4.3.398

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

Windows

Metode 1: Unduh melalui browser
  1. Buka URL berikut di browser untuk mengunduh agen Cloud Assistant.

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

  1. Instal prasyarat, seperti Git dan Go.

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

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. Navigasi 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 build

    Jika respons tidak berisi pesan error, instalasi berhasil.