All Products
Search
Document Center

Elastic Compute Service:Upgrade atau nonaktifkan auto-upgrade untuk Cloud Assistant Agent

Last Updated:May 16, 2026

Upgrade Cloud Assistant Agent untuk mengakses fitur-fitur terbaru, atau nonaktifkan auto-upgrade agar tetap menggunakan versi tertentu.

Batasan

Automatic upgrades

Penting

Di wilayah Meksiko dan Tiongkok (Zhongwei), Asisten Cloud tidak secara otomatis meningkatkan Instans yang menjalankan versi lebih lama dari yang tercantum di bawah ini. Untuk menggunakan fitur-fitur baru, panggil InstallCloudAssistant guna menginstal versi terbaru atau lakukan peningkatan manual. Lihat Instal Agen Asisten Cloud.

  • Linux: 2.2.3.515

  • Windows: 2.1.3.515

Secara default, Cloud Assistant Agent menjalankan program aliyun_assist_update setiap 30 menit. Lokasi program tersebut:

  • Instans Windows: C:\ProgramData\aliyun\assist\{VERSION}\aliyun_assist_update.exe

  • Instans Linux: /usr/local/share/aliyun-assist/{VERSION}/aliyun_assist_update

Catatan

{VERSION} merepresentasikan nomor versi Agen Asisten Cloud. Untuk melihat nomor versi tersebut, lihat Instal Agen Asisten Cloud.

Konfigurasikan kebijakan upgrade untuk mengatur jendela waktu upgrade dan menghindari gangguan selama jam sibuk.

  1. Buka ECS console - Cloud Assistant.

  2. Di pojok kanan atas, klik Settings.

    image

  3. Pada kotak dialog Cloud Assistant Settings, klik tab Cloud Assistant Agent Upgrade Settings.

  4. Pilih Cloud Assistant Agent Upgrade Settings, atur Period Allowed for Upgrade dan Time Zone, lalu klik OK.

    Catatan

    Anda dapat menentukan hingga lima periode waktu. Interval minimum antara dua periode adalah 1 jam.

    image

Disable automatic upgrades

  • Untuk menonaktifkan auto-upgrade pada versi tertentu, buat file konfigurasi untuk menonaktifkan automatic upgrades atau ganti nama program automatic upgrade.

  • Untuk menonaktifkan auto-upgrade pada semua versi, buat file konfigurasi untuk menonaktifkan automatic upgrades.

Rename the automatic upgrade program

Ganti nama file aliyun_assist_update untuk menonaktifkan auto-upgrade pada Cloud Assistant Agent.

Catatan

VERSION menunjukkan nomor versi Agen Asisten Cloud. Untuk informasi selengkapnya tentang cara melihat nomor versi, lihat Instal Agen Asisten Cloud.

  • Windows Server: Ganti nama aliyun_assist_update menjadi aliyun_assist_update.bk.

    Rename-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe'</span> -NewName 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe.bk'</span>
  • Linux: Ganti nama aliyun_assist_update menjadi aliyun_assist_update.bk.

    mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk

Untuk melanjutkan kembali auto-upgrade, ganti nama file tersebut kembali menjadi aliyun_assist_update.

  • Windows Server:

    Rename-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe.bk'</span> -NewName 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe'</span>
  • Linux:

    mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update

Create configuration files to disable automatic upgrades

Untuk Cloud Assistant Agent versi 2.2.1.140 atau lebih baru di Linux dan Cloud Assistant Agent versi 2.1.1.140 atau lebih baru di Windows, buat file konfigurasi untuk menonaktifkan auto-upgrade:

Step 1: Disable the Cloud Assistant Agent from checking for upgrades on startup

Buat file kosong bernama disable_bootstrap_update di direktori `config` pada direktori instalasi Cloud Assistant Agent. Hal ini akan menonaktifkan pemeriksaan upgrade saat startup untuk versi saat ini. Untuk menonaktifkannya pada semua versi, buat file tersebut di direktori `config` bersama.

  • Windows Server:

    # Contohnya, perintah berikut menonaktifkan pemeriksaan pembaruan saat startup untuk versi tertentu Agen Asisten Cloud.
    New-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\config\disable_bootstrap_update'
    # Contohnya, perintah berikut menonaktifkan pemeriksaan pembaruan saat startup untuk semua versi Agen Asisten Cloud.
    New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'
  • Linux:

    # Contohnya, perintah berikut menonaktifkan pemeriksaan upgrade saat startup untuk versi tertentu dari Cloud Assistant Agent.
    touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update
    # Contohnya, perintah berikut menonaktifkan pemeriksaan upgrade saat startup untuk semua versi Cloud Assistant Agent.
    touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
Catatan

VERSION menunjukkan nomor versi Agen Asisten Cloud. Untuk informasi selengkapnya tentang cara melihat nomor versi, lihat Instal Agen Asisten Cloud.

Step 2: Disable the Cloud Assistant Agent's automatic update check

Buat file kosong bernama disable_update di direktori `config` pada direktori instalasi Cloud Assistant Agent. Hal ini akan menonaktifkan pemeriksaan auto-upgrade periodik untuk versi tersebut. Untuk menonaktifkannya pada semua versi, buat file tersebut di direktori `config` bersama.

  • Windows Server:

    # Contohnya, perintah berikut menonaktifkan automatic upgrades untuk versi tertentu dari Cloud Assistant Agent.
    New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update
    # Contohnya, perintah berikut menonaktifkan automatic upgrades untuk semua versi Cloud Assistant Agent.
    New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
  • Linux:

    # Contohnya, perintah berikut menonaktifkan automatic upgrades untuk versi tertentu dari Cloud Assistant Agent.
    touch /usr/local/share/aliyun-assist/VERSION/config/disable_update
    # Contohnya, perintah berikut menonaktifkan automatic upgrades untuk semua versi Cloud Assistant Agent.
    touch /usr/local/share/aliyun-assist/config/disable_update
Catatan

VERSION menunjukkan nomor versi Agen Asisten Cloud. Untuk informasi selengkapnya tentang cara melihat nomor versi, lihat Instal Agen Asisten Cloud.

Untuk melanjutkan kembali auto-upgrade, hapus file disable_update dan disable_bootstrap_update.

  • Windows Server:

    Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update
    Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
    
    Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update
    Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update
  • Linux:

    rm /usr/local/share/aliyun-assist/VERSION/config/disable_update
    rm /usr/local/share/aliyun-assist/config/disable_update
    
    rm /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update
    rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update

Manual upgrade

Catatan

Untuk fitur yang didukung dan versi agen minimum, lihat Fitur dan Versi yang Didukung.

Upgrade using public commands

Jika auto-upgrade gagal, jalankan perintah publik untuk mengupgrade agent.

Penting

Langkah-langkah berikut menggunakan konsol. Untuk menjalankan perintah publik dengan OpenAPI atau CLI, lihat View and run public commands.

  1. Buka ECS console - Cloud Assistant.

  2. Pada halaman Cloud Assistant, klik tab Common Commands.

  3. Temukan versi terbaru dari perintah publik yang sesuai dan klik Run.

    • Instans Linux: ACS-ECS-UpdateAliyunAssist-linux.sh.

    • Instans Windows: ACS-ECS-UpdateAliyunAssist-windows.ps1.

      image.png

  4. Pada panel Run Command, konfigurasikan parameter dan klik Run.

    • Execution Plan: Pilih waktu untuk menjalankan perintah. Lihat Execution plan details.

    • Select Instance: Pilih instans yang akan diupgrade. Instans harus dalam status Running dan agent telah diinstal.

      Untuk detail parameter, lihat View and run public commands.

    Jika outputnya mirip seperti gambar berikut, Cloud Assistant Agent telah diupgrade.image.png

Catatan

Jika perintah publik gagal, periksa pesan error. Lihat Common errors and troubleshooting for failed executions.

Upgrade by manually downloading the installation package

Unduh paket instalasi terbaru untuk mengupgrade agent. Untuk metode instalasi, lihat Install the Cloud Assistant Agent.

Sebagai contoh, pada instans Linux x86, unduh dan instal paket RPM agent terbaru:

wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm

Maximum agent versions by kernel version

Kernel version

Maximum agent version

Linux kernel earlier than 2.6.32

  • x86/x64 architecture: 2.2.3.398

  • ARM architecture: 2.4.3.398

FreeBSD 11 or earlier (kernel version earlier than 12.x)

2.3.3.529