View a markdown version of this page

Tutorial: Membuat runbook menggunakan pengalaman desain visual - AWS Systems Manager
Langkah 1: Arahkan ke pengalaman desain visualLangkah 2: Buat alur kerjaLangkah 3: Tinjau kode yang dibuat secara otomatisLangkah 4: Jalankan runbook baru AndaLangkah 5: Bersihkan

• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola dasbor Amazon CloudWatch mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat dokumentasi CloudWatch Dasbor Amazon.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Membuat runbook menggunakan pengalaman desain visual

Dalam tutorial ini, Anda mempelajari dasar-dasar bekerja dengan pengalaman desain visual yang disediakan oleh Systems Manager Automation. Dalam pengalaman desain visual, Anda dapat membuat runbook yang menggunakan beberapa tindakan. Anda menggunakan fitur pindah untuk mengatur tindakan di kanvas. Anda juga mencari, memilih, dan mengonfigurasi tindakan ini. Kemudian, Anda dapat melihat kode YAML yang dibuat secara otomatis untuk alur kerja runbook Anda, keluar dari pengalaman desain visual, menjalankan runbook, dan meninjau detail eksekusi.

Tutorial ini juga menunjukkan cara memperbarui runbook dan melihat versi baru. Di akhir tutorial, Anda melakukan langkah pembersihan dan menghapus runbook Anda.

Setelah Anda menyelesaikan tutorial ini, Anda akan tahu cara menggunakan pengalaman desain visual untuk membuat runbook. Anda juga akan tahu cara memperbarui, menjalankan, dan menghapus runbook Anda.

catatan

Sebelum Anda memulai tutorial ini, pastikan untuk menyelesaikannyaMenyiapkan Otomatisasi.

  1. Masuk ke konsol Otomasi Manajer Sistem.

  2. Pilih Buat runbook otomatisasi.

Langkah 2: Buat alur kerja

Dalam pengalaman desain visual, alur kerja adalah representasi grafis dari runbook Anda di kanvas. Anda dapat menggunakan pengalaman desain visual untuk menentukan, mengkonfigurasi, dan memeriksa tindakan individual runbook Anda.

Untuk membuat alur kerja

  1. Di samping sak elar Desain dan Kode, pilih ikon pensil dan masukkan nama untuk runbook Anda. Untuk tutorial ini, masukkan VisualDesignExperienceTutorial.

    Pengalaman desain visual beri nama runbook Anda

  2. Di bagian Atribut dokumen pada panel Formulir, perluas dropdown parameter input, dan pilih Tambahkan parameter.

    1. Di bidang Nama parameter, masukkanInstanceId.

    2. Di dropdown Type, pilih AWS: :EC2: :Instance.

    3. Pilih sakelar yang Diperlukan.

    Buat parameter untuk runbook Anda

  3. Di browser AWS API, masukkan DescribeInstances di bilah pencarian.

  4. Pindahkan DescribeInstances tindakan Amazon EC2 — ke kanvas kosong.

  5. Untuk nama Langkah, masukkan nilai. Untuk tutorial ini, Anda dapat menggunakan namaGetInstanceState.

    Pilih tindakan API deskripsi instans Amazon EC2.

    1. Perluas dropdown input tambahan, dan di bidang Nama input, masukkanInstanceIds.

    2. Pilih tab Input.

    3. Di bidang nilai input, pilih input InstanceId dokumen. Ini merujuk nilai parameter input yang Anda buat di awal prosedur. Karena InstanceIds input untuk DescribeInstances tindakan menerima StringList nilai, Anda harus membungkus InstanceId input dalam tanda kurung persegi. YAML untuk nilai In put harus sesuai dengan yang berikut:['{{ InstanceId }}'].

    4. Di tab Out put, pilih Tambahkan output dan masukkan InstanceState di bidang Nama.

    5. Di bidang Selector, masukkan$.Reservations[0].Instances[0].State.Name.

    6. Di dropdown Type, pilih String.

  6. Pindahkan tindakan Cabang dari browser Actions, ke posisi di bawah GetInstanceState langkah.

  7. Untuk nama Langkah, masukkan nilai. Untuk tutorial ini, gunakan namanyaBranchOnInstanceState.

    Untuk menentukan logika percabangan, lakukan hal berikut:

    1. Pilih Branch negara di kanvas. Kemudian, di bawah In put dan Pilihan, pilih ikon pensil untuk mengedit Aturan #1.

    2. Pilih Tambahkan kondisi.

    3. Di kotak dialog Kondisi untuk aturan #1, pilih output GetInstanceState.InstanceState langkah dari dropdown Variabel.

    4. Untuk Operator, pilih sama dengan.

    5. Untuk Nilai, pilih String dari daftar dropdown. Masukkan stopped.

      Tentukan kondisi untuk tindakan cabang.

    6. Pilih Simpan kondisi.

    7. Pilih Tambahkan aturan pilihan baru.

    8. Pilih Tambahkan kondisi untuk A turan #2.

    9. Di kotak dialog Kondisi untuk aturan #2, pilih output GetInstanceState.InstanceState langkah dari dropdown Variabel.

    10. Untuk Operator, pilih sama dengan.

    11. Untuk Nilai, pilih String dari daftar dropdown. Masukkan stopping.

    12. Pilih Simpan kondisi.

    13. Pilih Tambahkan aturan pilihan baru.

    14. Untuk Aturan #3, pilih Tambahkan kondisi.

    15. Di kotak dialog Kondisi untuk aturan #3, pilih output GetInstanceState.InstanceState langkah dari dropdown Variabel.

    16. Untuk Operator, pilih sama dengan.

    17. Untuk Nilai, pilih String dari daftar dropdown. Masukkan running.

    18. Pilih Simpan kondisi.

    19. Pada aturan Default, pilih Go to end untuk langkah Default.

  8. Pindahkan tindakan U bah status instance ke kotak Drag action here kosong di bawah kondisi {{ GetInstanceState.InstanceState }} == “berhenti”.

    1. Untuk nama Langkah, masukkanStartInstance.

    2. Di tab Input, di bawah Inst ance ID, pilih nilai input InstanceId dokumen dari dropdown.

    3. Untuk status yang diinginkan, tentukan running.

  9. Pindahkan tindakan Tun AWS ggu sumber daya ke kotak Drag action here kosong di bawah kondisi {{ GetInstanceState.InstanceState }} == “berhenti”.

  10. Untuk nama Langkah, masukkan nilai. Untuk tutorial ini, gunakan namanyaWaitForInstanceStop.

    1. Untuk bidang Layanan, pilih Amazon EC2.

    2. Untuk bidang API, pilih DescribeInstances.

    3. Untuk bidang pemilih properti, masukkan$.Reservations[0].Instances[0].State.Name.

    4. Untuk parameter nilai yang diinginkan, masukkan["stopped"].

    5. Di tab Konfigurasi WaitForInstanceStop tindakan, pilih StartInstance dari dropdown Langkah berikutnya.

  11. Pindahkan perintah Run on instance action ke kotak Drag action here yang kosong di bawah kondisi {{ GetInstanceState.InstanceState }} == “running”.

  12. Untuk nama Langkah, masukkanSayHello.

    1. Di tab Input, masukkan AWS-RunShellScript untuk parameter Nama Dok umen.

    2. Untuk InstanceIds, pilih nilai input InstanceId dokumen dari dropdown.

    3. Perluas dropdown input tambahan, dan di dropdown nama Input, pilih Parameter.

    4. Di bidang Input value, masukkan{"commands": "echo 'Hello World'"}.

  13. Tinjau runbook yang sudah selesai di kanvas dan pilih Buat runbook untuk menyimpan runbook tutorial.

    Tinjau dan buat runbook.

Langkah 3: Tinjau kode yang dibuat secara otomatis

Saat Anda memindahkan tindakan dari browser T indakan ke kanvas, pengalaman desain visual secara otomatis menyusun konten YAML atau JSON dari runbook Anda secara real-time. Anda dapat melihat dan mengedit kode ini. Untuk melihat kode yang dibuat secara otomatis, pilih Kode untuk sakelar Desain dan Kode.

Langkah 4: Jalankan runbook baru Anda

Setelah membuat runbook Anda, Anda dapat menjalankan otomatisasi.

Untuk menjalankan runbook otomatisasi baru Anda

  1. Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/.

  2. Di panel navigasi, pilih Otomatisasi, lalu pilih Eksekusi otomatisasi.

  3. Di daftar Dokumen otomatisasi, pilih runbook. Pilih satu opsi atau lebih di panel Kategori dokumen untuk memfilter dokumen SSM sesuai dengan tujuannya. Untuk melihat runbook yang Anda miliki, pilih tab Dimiliki oleh saya. Untuk melihat runbook yang dibagikan dengan akun Anda, pilih tab Dibagikan dengan saya. Untuk melihat semua runbook, pilih tab Semua dokumen.

    catatan

    Anda dapat melihat informasi tentang runbook dengan memilih nama runbook.

  4. Di bagian Detail dokumen, verifikasi bahwa Versi dokumen diatur ke versi yang ingin Anda jalankan. Sistem ini termasuk pilihan versi berikut:

    • Versi default saat runtime — Pilih opsi ini jika runbook Otomasi diperbarui secara berkala dan versi default baru ditetapkan.

    • Versi terbaru saat runtime — Pilih opsi ini jika runbook Otomasi diperbarui secara berkala, dan Anda ingin menjalankan versi yang terbaru diperbarui.

    • 1 (Default) — Pilih opsi ini untuk menjalankan versi pertama dokumen, yang merupakan default.

  5. Pilih Berikutnya.

  6. Di bagian Run book Otomasi Jalankan, pilih Ek sekusi sederhana.

  7. Di bagian Parameter input, tentukan input yang diperlukan. Secara opsional, Anda dapat memilih peran layanan IAM dari AutomationAssumeRole daftar.

  8. (Opsional) Pilih CloudWatch alarm untuk diterapkan ke otomatisasi Anda untuk pemantauan. Jika alarm Anda memasuki ALARM status, otomatisasi dibatalkan dan setiap onCancel langkah yang ditentukan dijalankan. Jika Anda menggunakan AWS CloudTrail, Anda melihat panggilan StopAutomationExecution API di jejak Anda. Untuk informasi selengkapnya, lihat Mengkonfigurasi Otomatisasi untuk memantau Alarm CloudWatch.

  9. Pilih Eksekusi.

Langkah 5: Bersihkan

Untuk menghapus runbook Anda

  1. Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/.

  2. Di panel navigasi, pilih Dokumen.

  3. Pilih tab Dimiliki oleh saya.

  4. Temukan VisualDesignExperienceTutorial runbook.

  5. Pilih tombol pada halaman kartu dokumen, lalu pilih H apus dokumen dari tarik-turun T ind akan.