Tutorial: Buat 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

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

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 YAML kode 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 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.

    Pengalaman desain visual memberi 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 AWS APIsbrowser, 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.

    Pilih API tindakan EC2 mendeskripsikan instans Amazon.

    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. Nilai YAML untuk Input harus sesuai 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.

      Tentukan kondisi untuk tindakan cabang.

    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 Instance IDs, 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 APIbidang, 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.

    Tinjau dan buat runbook.

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 YAML atau JSON konten 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 atau beberapa opsi di panel Kategori dokumen untuk memfilter SSM dokumen 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 Execute Automation Runbook, pilih Eksekusi sederhana.

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

  8. (Opsional) Pilih CloudWatch alarm Amazon untuk diterapkan ke otomatisasi Anda untuk pemantauan. Untuk memasang CloudWatch alarm ke otomatisasi Anda, IAM kepala sekolah 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 API panggilan 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.