Tutorial: Buat runbook menggunakan pengalaman desain visual

Dalam tutorial ini, Anda akan 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 drag and drop untuk mengatur tindakan di kanvas. Anda juga mencari, memilih, dan mengonfigurasi tindakan ini. Kemudian, Anda dapat melihat kode YAMAL 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.

Langkah 1: Arahkan ke pengalaman desain visual

1. Masuk ke konsol Otomasi Systems Manager.

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, mengonfigurasi, dan memeriksa tindakan individual dari runbook Anda.

Untuk membuat alur kerja

1. Di sebelah sakelar Desain dan Kode, pilih ikon pensil dan masukkan nama untuk runbook Anda. Untuk tutorial ini, masukkan VisualDesignExperienceTutorial.

   

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.

   

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

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

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

   

   1. Perluas tarik-turun input tambahan, dan di bidang Nama input, masukkan. InstanceIds

   2. Pilih tab Input.

   3. Di bidang Nilai input, pilih input InstanceId dokumen. Ini mereferensikan nilai parameter input yang Anda buat di awal prosedur. Karena InstanceIdsinput untuk DescribeInstances tindakan menerima StringList nilai, Anda harus membungkus InstanceIdinput dalam tanda kurung siku. YAMG untuk nilai Input harus cocok dengan yang berikut:['{{ InstanceId }}'].

   4. Di tab Output, 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. Seret tindakan Branch dari browser Actions, dan jatuhkan di bawah GetInstanceStatelangkah.

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

   Untuk menentukan logika percabangan, lakukan hal berikut:

   1. Pilih Branchstatus di kanvas. Kemudian, di bawah Input dan Pilihan, pilih ikon pensil untuk mengedit Aturan #1.

   2. Pilih Tambahkan kondisi.

   3. Dalam kotak dialog Conditions for rule #1, pilih output GetInstanceState.InstanceState langkah dari dropdown Variable.

   4. Untuk Operator, pilih sama dengan.

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

      

   6. Pilih Simpan kondisi.

   7. Pilih Tambahkan aturan pilihan baru.

   8. Pilih Tambahkan kondisi untuk Aturan #2.

   9. Dalam kotak dialog Conditions for rule #2, pilih output GetInstanceState.InstanceState langkah dari dropdown Variable.

   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. Dalam kotak dialog Conditions for rule #3, pilih output GetInstanceState.InstanceState langkah dari dropdown Variable.

   16. Untuk Operator, pilih sama dengan.

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

   18. Pilih Simpan kondisi.

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

8. Seret tindakan Change an instance state ke kotak Drag action here kosong di bawah {{ GetInstanceState. InstanceState }} == kondisi “berhenti”.

   1. Untuk nama Langkah, masukkanStartInstance.

   2. Di tab Inputs, di bawah ID Instance, pilih nilai input InstanceIddokumen dari dropdown.

   3. Untuk status yang diinginkan, tentukan running.

9. Seret aksi Tunggu AWS sumber daya ke kotak Drag action here kosong di bawah {{ GetInstanceState. InstanceState }} == kondisi “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 WaitForInstanceStoptindakan, pilih StartInstancedari dropdown langkah Berikutnya.

11. Seret perintah Jalankan pada tindakan instance ke kotak Drag action here kosong di bawah {{ GetInstanceState. InstanceState }} == kondisi “berjalan”.

12. Untuk nama Langkah, masukkanSayHello.

    1. Di tab Input, masukkan AWS-RunShellScript parameter nama Dokumen.

    2. Untuk InstanceIds, pilih nilai input InstanceIddokumen dari dropdown.

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

    4. Di bidang Nilai input, masukkan{"commands": "echo 'Hello World'"}.

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

    

Langkah 3: Tinjau kode yang dibuat secara otomatis

Saat Anda menyeret dan melepaskan tindakan dari browser Actions ke kanvas, pengalaman desain visual secara otomatis menyusun konten YAMG 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 Desain dan Kode sakelar.

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

6. Di bagian Execute Automation Runbook, pilih Eksekusi sederhana.

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

8. (Opsional) Pilih CloudWatch alarm Amazon untuk diterapkan ke otomatisasi Anda untuk pemantauan. Untuk memasang CloudWatch alarm ke otomatisasi Anda, prinsipal IAM yang memulai otomatisasi harus memiliki izin untuk iam:createServiceLinkedRole tindakan tersebut. Untuk informasi selengkapnya tentang CloudWatch alarm, lihat Menggunakan CloudWatch alarm Amazon. Jika alarm Anda aktif, otomatisasi dihentikan. Jika Anda menggunakan AWS CloudTrail, Anda akan melihat panggilan API di jejak Anda.

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

5. Pilih tombol pada halaman kartu dokumen, lalu pilih Hapus dokumen dari dropdown Tindakan.