Perintah Cloud Assistant memungkinkan Anda menjalankan tugas rutin pada instans Elastic Compute Service (ECS) secara cepat, seperti menjalankan skrip O&M otomatis, memantau proses, mengatur ulang kata sandi pengguna, menginstal atau menguninstall perangkat lunak, memperbarui aplikasi, dan menginstal patch. Sebuah perintah dapat berupa skrip Windows PowerShell, skrip Windows Bat, atau skrip Linux Shell, serta mendukung parameter kustom yang memungkinkan Anda menetapkan nilai variabel.
Batasan
| Resource | Limit |
|---|---|
| Jumlah perintah per wilayah | 500–50.000 (kuota per akun; dapat meningkat seiring penggunaan ECS) |
| Ukuran maksimum skrip terenkode Base64 | 18 KB |
Untuk melihat atau menambah kuota Anda, lihat Manage quotas. Sertakan alasan detail dalam permintaan Anda untuk meningkatkan peluang persetujuan.
Prosedur
Buat perintah di Konsol ECS
-
Buka halaman ECS Cloud Assistant.
-
Pada bilah navigasi atas, pilih wilayah dan kelompok sumber daya.
Setelah Anda menetapkan perintah ke kelompok sumber daya, Anda dapat mengelola izin perintah di tingkat kelompok sumber daya tersebut. Tambahkan kebijakan akses yang diperlukan ke kelompok sumber daya tersebut. Untuk kebijakan akses yang berlaku pada perintah Cloud Assistant dan otorisasi kelompok sumber daya, lihat Cloud Assistant command-specific sample custom policies dan Classify resources into resource groups and grant permissions on the resource groups.
-
Pada halaman ECS Cloud Assistant, klik Create/Run Command.
-
Pada bagian Command Information, konfigurasikan perintah. Command type: Pilih jenis yang sesuai dengan OS instans target Anda. Command content: Masukkan atau tempel perintah. Verifikasi sintaks, logika, dan algoritma sebelum menyimpan. Contoh — arsipkan file ke
/backuppada instans Linux:-
Run at Fixed Interval: Tetapkan interval (60 detik–7 hari) menggunakan ekspresi laju. Interval ini adalah jeda antara dua eksekusi berturut-turut, bukan durasi eksekusi. Misalnya, interval 5 menit dengan waktu eksekusi 2 menit berarti eksekusi berikutnya dimulai 3 menit setelah eksekusi sebelumnya selesai. Eksekusi pertama dimulai setelah interval berlalu sejak pembuatan tugas. > Note: Interval harus lebih panjang daripada periode timeout perintah.
-
Run on Clock-based Schedule Cron Expression: Tentukan ekspresi cron (akurat hingga detik) dan zona waktu. Interval minimum: 10 detik (harus lebih panjang daripada periode timeout). Contoh:
0 0 12 ? * WED 2022dengan (GMT+08:00) Asia/Shanghai dijalankan setiap Rabu pukul 12:00:00 pada tahun 2022. Lihat Cron expressions.
Execution plan
Option Behavior Precheck only Melakukan pemeriksaan awal terhadap permintaan tanpa menerapkan perintah. Pemeriksaan mencakup parameter permintaan, lingkungan eksekusi instans, dan status Cloud Assistant Agent. Run on schedule Menjalankan perintah sebagai tugas terjadwal. Lihat opsi berikutnya. Parameter lainnya
Parameter Description Command Name Nama untuk perintah tersebut. Command Description Deskripsi tujuan perintah. Username Pengguna OS yang menjalankan perintah. Nilai default: root(Linux),system(Windows). Gunakan hak istimewa seminimal mungkin. Lihat Run Cloud Assistant commands as a regular user.Execution Path Direktori tempat skrip dijalankan pada instans. Nilai default: /rootuntuk Linux danC:\Windows\system32untuk Windows. Untuk memastikan skrip dijalankan di direktori yang diharapkan, tambahkan perintahcddi awal skrip.Timeout Waktu eksekusi maksimum. Nilai valid: 10 hingga 86.400 detik (24 jam). Nilai default: 60 detik. Nilai di bawah 10 akan diatur menjadi 10. Task termination mode Menentukan cara tugas dihentikan saat Anda menghentikannya.
-
Script Process: menghentikan proses skrip.
-
Process Tree: menghentikan seluruh pohon proses, yaitu proses skrip dan semua proses anak yang dibuatnya.
Command content: Anda dapat mengaktifkan Use Parameters. Setelah dienkripsi Base64, konten perintah tidak boleh melebihi 18 KB jika Anda memilih Run and Save, atau 24 KB jika Anda memilih Run.
Custom parameters: Definisikan parameter dalam format
{{parameter}}dan tetapkan nilainya secara manual. Parameter kustom mendukung nilai dinamis dan memungkinkan Anda menggunakan satu nilai di beberapa tempat.Built-in parameters: Cloud Assistant menyediakan parameter bawaan yang secara otomatis diganti saat runtime dan tidak perlu ditetapkan secara manual, seperti
{{ACS::RegionId}}untuk ID wilayah dan{{ACS::InstanceId}}untuk ID instans.#!/bin/bash # Contoh # {{name}} adalah parameter kustom. Tetapkan nilainya setelah Anda selesai menulis konten perintah. echo {{name}} # {{ACS::RegionId}} adalah parameter bawaan dan tidak perlu ditetapkan secara manual. echo {{ACS::RegionId}} -
-
Pada Select Instance atau Select Managed Instances, pilih instans target. Anda dapat memilih beberapa instans, hingga 100 sekaligus.
-
Klik Save.
Buat perintah menggunakan Alibaba Cloud CLI
Contoh permintaan
Panggil CreateCommand untuk membuat perintah. Contoh berikut membuat perintah bernama update yang memperbarui OS pada instans Linux.
aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
Ganti nilai dalam tanda petik tunggal dengan nilai aktual Anda.
Tabel berikut menjelaskan parameter utama. Untuk referensi lengkap semua parameter, lihat CreateCommand.
| Parameter | Contoh | Description |
|---|---|---|
RegionId |
cn-hangzhou |
Wilayah. |
Name |
update |
Nama perintah. |
Type |
RunShellScript |
Jenis perintah: RunShellScript (Linux Shell), RunBatScript (Windows Bat), atau RunPowerShellScript (Windows PowerShell). |
CommandContent |
eXVtIHVwZGF0ZSAteQ== |
Konten perintah yang telah dienkripsi Base64. |
Description |
update |
Deskripsi perintah. |
Contoh respons
CommandId
---------
c-hz018qng4on****
Langkah selanjutnya
Setelah membuat perintah, Anda dapat melihat detailnya di tab My Commands. Untuk menjalankan perintah pada instans tertentu, lihat Run a command.
Jika perintah menggunakan parameter, masukkan nilai parameternya di kolom Command Parameters saat menjalankan perintah.