Fitur, skenario, dan operasi umum Cloud Assistant - Elastic Compute Service

Cloud Assistant menjalankan perintah Shell, PowerShell, dan Bat di berbagai instance ECS tanpa bastion host dan tanpa biaya tambahan.

Fitur

Operasi batch: Jalankan perintah pada beberapa instance secara bersamaan. Eksekusi diisolasi per instance—kegagalan pada satu instance tidak memengaruhi yang lain.
Unggah file: Kirim file konfigurasi, skrip, atau aset lain ke instance.
Perintah publik: Skrip dan plugin pra-buat untuk tugas umum seperti audit keamanan, patching OS, dan instalasi aplikasi.
Perintah berparameter: Tentukan parameter kustom atau bawaan untuk membuat templat perintah yang dapat digunakan ulang. Satu templat dapat melayani berbagai skenario dengan menyisipkan nilai berbeda saat runtime.
Keamanan dan kontrol: Cloud Assistant tidak pernah memulai aksi secara mandiri—Anda tetap memiliki kendali penuh atas setiap operasi.

Kasus penggunaan

Penerapan software: Dorong kode aplikasi, pembaruan konfigurasi, atau hotfix ke armada instance dalam satu operasi.
Patching keamanan: Sebarkan patch OS atau pembaruan keamanan ke semua instance tanpa login satu per satu.
Manajemen siklus hidup software: Kelola siklus hidup pengembangan software di berbagai instance.
Konfigurasi instance: Ubah hostname atau atur ulang kredensial pengguna secara batch.
Pemantauan proses: Periksa status proses atau kesehatan layanan di berbagai instance dan kumpulkan hasilnya secara terpusat.
Manajemen paket: Ambil dan instal pembaruan dari repositori OSS atau YUM.

Operasi umum

Tabel berikut memetakan tugas umum ke dokumentasi dan referensi API-nya.

Task	Dokumentasi	API
Install the agent	Install Cloud Assistant Agent	InstallCloudAssistant, DescribeCloudAssistantStatus
Use the SDK	Run commands using an SDK	--
Create a command	Create a command	RunCommand, CreateCommand
Run a command	Run a command	RunCommand, InvokeCommand
Check results	View execution results and troubleshoot common issues	DescribeInvocations, DescribeInvocationResults
Modify a command	Modify a command	--
Clone a command	Clone a command	--
Stop a command	Stop a command	StopInvocation
Delete a command	Delete a command	DeleteCommand

Catatan

Cloud Assistant Agent telah dipra-instal pada instance ECS yang dibuat dari gambar publik setelah 1 Desember 2017.

Persyaratan instance

Instance harus berada dalam status Running.
Cloud Assistant Agent harus diinstal. Agen ini telah dipra-instal pada instance yang dibuat dari gambar publik setelah 1 Desember 2017. Untuk gambar kustom atau Gambar Marketplace Alibaba Cloud, verifikasi kompatibilitas dan install Cloud Assistant Agent secara manual jika diperlukan.

Sistem operasi yang didukung

Linux

Alibaba Cloud Linux
CentOS 6, 7, 8, dan versi selanjutnya
CoreOS
version.ini — konfigurasi versi Agent.
OpenSUSE
Red Hat 5, 6, 7, dan versi selanjutnya

Catatan
Red Hat memerlukan instalasi RPM manual. Lihat Install Cloud Assistant Agent.
SUSE Linux Enterprise Server 11, 12, 15, dan versi selanjutnya
Ubuntu 12, 14, 16, 18, dan versi selanjutnya
FreeBSD 11, 12, 13, 14, dan versi selanjutnya

Windows

Windows Server 2012, 2016, 2019, dan versi selanjutnya

Batas muatan dan parameter

Semua ukuran mengacu pada muatan yang dikodekan Base64.

Operasi	Ukuran maksimum
Create command	18 KB
Run immediately (save command)	18 KB
Run immediately (do not save)	24 KB
Upload file	32 KB

Setiap perintah mendukung hingga 20 parameter kustom.

Matriks kompatibilitas fitur

Beberapa fitur memerlukan versi minimum Cloud Assistant Agent.

Fitur	Versi min (Linux)	Versi min (Windows)
Agent heartbeat reporting	1.0.2.458	1.0.0.149
File distribution	1.0.2.569	1.0.0.149
Run as specific user	2.2.0.106	2.1.0.50
Run on next boot	2.2.0.46	2.1.0.50
Run on every boot	2.2.0.46	2.1.0.50
Session Manager support	2.2.3.196	2.1.3.196
Scheduled tasks (Rate/At expressions)	2.2.3.282	2.1.3.282
Scheduled tasks (Cron with year/timezone)	2.2.3.282	2.1.3.282
Built-in environment parameters	2.2.3.309	2.1.3.309
Instance names as parameter	2.2.3.344	2.1.3.344
Stop or restart via exit code	2.2.3.317	2.1.3.317
Container execution (by name)	2.2.3.344	2.1.3.344
Container execution (by ID)	2.2.3.344	2.1.3.344

Penagihan

Cloud Assistant sendiri gratis. Anda hanya dikenai biaya untuk resource ECS (komputasi, jaringan, penyimpanan) yang dikonsumsi selama eksekusi tugas. Lihat Billing overview.

Overhead sumber daya

Cloud Assistant Agent memiliki dampak minimal terhadap performa instance.

Resource	Linux	Windows
CPU	< 1% rata-rata utilisasi	< 1% rata-rata utilisasi
Physical memory	~20 MB	~30 MB
Disk I/O	Negligible (peaks only during upgrades or script saving)	Negligible (peaks only during upgrades or script saving)
Network I/O	Minimal (heartbeat traffic)	Minimal (heartbeat traffic)

Status eksekusi perintah

Cloud Assistant melacak eksekusi pada dua tingkat: tingkat instance (status per instance) dan tingkat invocation (status agregat di semua instance target dalam satu batch).

Relationship between invocation status and instance-level status

Status tingkat instance

Status-status ini sesuai dengan field InvocationStatus di bawah InvokeInstance dalam DescribeInvocations, atau field InvocationStatus dalam DescribeInvocationResults.

Kode status	Deskripsi
`Pending`	Sistem sedang memverifikasi atau mengirim perintah.
`Invalid`	Jenis perintah atau parameter tidak valid.
`Aborted`	Gagal dikirim. Instance harus berstatus `Running` dan perintah harus dikirim dalam waktu 1 menit.
`Running`	Perintah sedang dieksekusi di instance.
`Success`	Selesai dengan exit code 0. Untuk tugas terjadwal, eksekusi terakhir selesai dengan exit code 0 dan jadwal telah berakhir.
`Failed`	Selesai dengan exit code bukan nol. Untuk tugas terjadwal, exit code bukan nol pada eksekusi terakhir akan menghentikan tugas tersebut.
`Error`	Terjadi pengecualian.
`Timeout`	Melebihi periode timeout yang ditentukan.
`Cancelled`	Dibatalkan sebelum eksekusi dimulai.
`Stopping`	Permintaan stop telah dikirim; eksekusi sedang dihentikan.
`Stopped`	Dihentikan secara manual.
`Terminated`	Dihentikan selama runtime.
`Scheduled`	Menunggu jendela eksekusi terjadwal berikutnya.

Status tingkat invocation

Untuk perintah batch, Cloud Assistant mengagregasi status instance menjadi satu status invocation yang dikembalikan dalam field InvocationStatus dari DescribeInvocations.

Kode status	Aturan agregasi
`Pending`	Setidaknya satu instance berstatus `Pending`.
`Scheduled`	Setidaknya satu instance berstatus `Scheduled`.
`Running`	Setidaknya satu instance berstatus `Running`.
`Success`	Semua instance selesai. Setidaknya satu melaporkan `Success`. Untuk tugas langsung, selesai dengan exit code 0. Untuk tugas terjadwal, eksekusi terakhir selesai dengan exit code 0 dan jadwal telah berakhir.
`Failed`	Semua instance selesai, tetapi tidak ada yang berhasil. Instance dianggap gagal jika melaporkan `Invalid`, `Aborted`, `Failed`, `Timeout`, atau `Error`.
`Stopping`	Setidaknya satu instance berstatus `Stopping`.
`Stopped`	Semua instance melaporkan `Stopped` — semua tugas dibatalkan (`Cancelled`) atau dihentikan (`Terminated`).
`PartialFailed`	Semua instance selesai dengan hasil campuran — sebagian berhasil dan sebagian gagal atau dihentikan.

Izin (RAM)

Akun Alibaba Cloud memiliki akses penuh ke Cloud Assistant secara default. Untuk penggunaan produksi, buat Pengguna RAM dan berikan hanya izin yang diperlukan. Lihat Grant permissions to a RAM user to use Cloud Assistant.

Arsitektur agen dan struktur direktori

Linux

Cloud Assistant Agent diinstal di /usr/local/share/aliyun-assist/.

/usr/local/share/aliyun-assist/
- 2.x.x.xxx/ — Direktori spesifik versi (misalnya, 2.2.4.965/).
  - aliyun-service — Binary inti agen.
  - assist_daemon — Daemon (watchdog) yang memantau aliyun-service dan me-restart-nya jika crash.
  - acs-plugin-manager — Utilitas manajemen plugin.
  - aliyun_assist_update — Utilitas pembaruan otomatis.
  - aliyun_installer — Deprecated. Digantikan oleh acs-plugin-manager.
  - config/
    - GlobalSignRootCA.crt — Sertifikat root untuk komunikasi HTTPS.
    - hash_file — Hash kriptografi untuk verifikasi integritas.
  - init/
    - install, uninstall, clean — Skrip instalasi, uninstall, dan pembersihan.
    - version — Versi agen saat ini.
  - log/
    - aliyun_assist_main.log — File log aktif (hari ini).
    - aliyun_assist_main.log.YYYYMMDD — Log arsip (dirotasi harian).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin pengumpulan informasi sistem yang telah dipra-instal.
- cache/
  - state_configs.json — Konfigurasi cache untuk pengumpulan inventaris CloudOps Orchestration Service (OOS).
- config/
  - task_sign_certs/ — Kunci publik untuk verifikasi tanda tangan digital tugas.
- hybrid/
  - hardwareHash — Sidik jari perangkat keras untuk pendaftaran instans terkelola.
- plugin/
  - installed_plugins.db — Database plugin yang diinstal.
- work/
  - script/ — Direktori staging untuk skrip eksekusi.
    
    Catatan
    Mulai dari versi 2.x.3.704, Cloud Assistant tidak lagi menyimpan skrip eksekusi ke disk secara default. Aktifkan fitur penyimpanan skrip secara manual untuk melihat file yang dieksekusi di direktori ini.
- region-id — ID Wilayah instance.

Windows

Cloud Assistant Agent diinstal di C:\ProgramData\aliyun\assist\.

C:\ProgramData\aliyun\assist\
- 2.x.x.xxx/ — Direktori spesifik versi (misalnya, 2.1.4.965).
  - aliyun_assist_service.exe — Binary inti agen.
  - acs-plugin-manager.exe — Utilitas manajemen plugin.
  - aliyun_assist_update.exe — Utilitas pembaruan otomatis.
  - aliyun_installer.exe — Program installer.
  - install.bat, install.exe — Skrip instalasi.
  - PatchGo.dll — Patch runtime untuk Windows Server 2008 guna mengurangi deviasi jam Go.
  - version.ini — Konfigurasi versi agen.
  - config/
    - GlobalSignRootCA.crt — Sertifikat root untuk komunikasi HTTPS.
    - hash_file — Hash kriptografi untuk verifikasi integritas.
  - log/
    - aliyun_assist_main.log — File log aktif (hari ini).
    - aliyun_assist_main.log.YYYYMMDD — Log arsip (dirotasi harian).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin pengumpulan informasi sistem.
    - SessionManager — Plugin manajemen sesi tanpa kata sandi.
    - installed_plugins.db — Database plugin yang diinstal.
- cache/
  - state_configs.json — Konfigurasi cache untuk pengumpulan inventaris OOS.
- config/
  - task_sign_certs/ — Kunci publik untuk verifikasi tanda tangan tugas.
- hybrid/ — Data pendaftaran instans terkelola.
- plugin/
  - installed_plugins.db — Database plugin.
- work/
  - script/ — Direktori staging untuk skrip eksekusi.
    
    Catatan
    Mulai dari versi 2.x.3.704, Cloud Assistant tidak lagi menyimpan skrip eksekusi ke disk secara default. Aktifkan fitur penyimpanan skrip secara manual untuk melihat file yang dieksekusi di direktori ini.
- config.ini — Konfigurasi global, termasuk versi agen saat ini.
- region-id — ID Wilayah instance.
- version — Versi agen saat ini.

Istilah

Istilah	Deskripsi
Cloud Assistant	Layanan ini. Tersedia di semua Wilayah Alibaba Cloud.
Cloud Assistant Agent	Binary client di setiap instance. Nama proses: `aliyun-service` (Linux) atau `aliyun_assist_service` (Windows).
AssistDaemon	Watchdog yang memantau dan me-restart agen jika crash. Hanya untuk Linux. Nama layanan: `AssistDaemon`. Path: `/usr/local/share/assist-daemon/assist_daemon`.
Working directory	Path tempat skrip distaging sementara (jika penyimpanan skrip diaktifkan). Linux: `/tmp`. Windows: `<Cloud Assistant installation path>/work/script`.
Command	Muatan operasi yang dikirim ke instance. Jenis: Shell, PowerShell, dan Bat.
Custom parameter	Variabel yang didefinisikan dengan sintaks `{{key}}`. Nilai disisipkan saat runtime menggunakan `{{"key":"value"}}`. Gunakan parameter kustom untuk membuat templat perintah yang dapat digunakan ulang dan mengoptimalkan penggunaan terhadap kuota regional. Cloud Assistant juga menyediakan parameter lingkungan bawaan yang diisi secara otomatis saat runtime.
One-time execution	Event eksekusi tunggal pada satu atau beberapa instance (juga disebut invocation).
Scheduled execution	Perintah yang dikonfigurasi untuk dijalankan secara berkala