

• 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 CloudWatch dasbor Amazon mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat [dokumentasi CloudWatch Dasbor Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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
<a name="visual-designer-tutorial"></a>

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 menyelesaikannya[Menyiapkan Otomatisasi](automation-setup.md).

**Topics**
+ [Langkah 1: Arahkan ke pengalaman desain visual](#navigate-console)
+ [Langkah 2: Buat alur kerja](#create-workflow)
+ [Langkah 3: Tinjau kode yang dibuat secara otomatis](#view-generated-code)
+ [Langkah 4: Jalankan runbook baru Anda](#use-tutorial-runbook)
+ [Langkah 5: Bersihkan](#cleanup-tutorial-runbook)

## Langkah 1: Arahkan ke pengalaman desain visual
<a name="navigate-console"></a>

1. Masuk ke [konsol Otomasi Systems Manager](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/).

1. Pilih **Buat runbook otomatisasi**.

## Langkah 2: Buat alur kerja
<a name="create-workflow"></a>

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\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/images/visual_designer_tutorial_name.png)

1. Di bagian **Atribut dokumen** pada panel **Formulir**, perluas dropdown **parameter Input**, dan pilih **Tambahkan** parameter.

   1. Di bidang **Nama parameter**, masukkan**InstanceId**.

   1. Di dropdown **Type**, pilih. **AWS::EC2::Instance**

   1. Pilih sakelar **Diperlukan**.  
![\[Buat parameter untuk runbook Anda\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/images/visual_designer_actions_tutorial_parameter.png)

1. Di **AWS APIs**browser, masukkan **DescribeInstances** di bilah pencarian.

1. Seret **Amazon EC2 — DescribeInstances** tindakan ke kanvas kosong.

1. Untuk **nama Langkah**, masukkan nilai. Untuk tutorial ini, Anda dapat menggunakan nama**GetInstanceState**.  
![\[Pilih tindakan API deskripsi instans Amazon EC2.\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/images/visual_designer_tutorial_api_action.png)

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

   1. Pilih tab **Input**.

   1. Di bidang **Nilai input**, pilih input **InstanceId** dokumen. Ini mereferensikan 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 siku. YAMG untuk **nilai Input** harus cocok dengan yang berikut:**['\$1\$1 InstanceId \$1\$1']**.

   1. Di tab **Output**, pilih **Tambahkan output** dan masukkan **InstanceState** di bidang **Nama**.

   1. Di bidang **Selector**, masukkan**\$1.Reservations[0].Instances[0].State.Name**.

   1. **Di dropdown **Type**, pilih String.**

1. Seret tindakan **Branch** dari browser **Actions**, dan jatuhkan di bawah **`GetInstanceState`**langkah. 

1. Untuk **nama Langkah**, masukkan nilai. Untuk tutorial ini, gunakan namanya`BranchOnInstanceState`.

   Untuk menentukan logika percabangan, lakukan hal berikut:

   1. Pilih **`Branch`**status di kanvas. Kemudian, di bawah **Input** dan **Pilihan**, pilih ikon pensil untuk mengedit **Aturan \$11**.

   1. Pilih **Tambahkan kondisi**.

   1. Dalam kotak dialog **Conditions for rule \$11**, pilih output **GetInstanceState.InstanceState** langkah dari dropdown **Variable**.

   1. Untuk **Operator**, pilih **sama dengan**.

   1. Untuk **Nilai**, pilih **String** dari daftar dropdown. Masukkan **stopped**.  
![\[Tentukan kondisi untuk tindakan cabang.\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/images/visual_designer_tutorial_condition.png)

   1. Pilih **Simpan kondisi**.

   1. Pilih **Tambahkan aturan pilihan baru**.

   1. Pilih **Tambahkan kondisi** untuk **Aturan \$12**.

   1. Dalam kotak dialog **Conditions for rule \$12**, pilih output **GetInstanceState.InstanceState** langkah dari dropdown **Variable**.

   1. Untuk **Operator**, pilih **sama dengan**.

   1. Untuk **Nilai**, pilih **String** dari daftar dropdown. Masukkan **stopping**.

   1. Pilih **Simpan kondisi**.

   1. Pilih **Tambahkan aturan pilihan baru**.

   1. Untuk **Aturan \$13**, pilih **Tambahkan kondisi**.

   1. Dalam kotak dialog **Conditions for rule \$13**, pilih output **GetInstanceState.InstanceState** langkah dari dropdown **Variable**.

   1. Untuk **Operator**, pilih **sama dengan**.

   1. Untuk **Nilai**, pilih **String** dari daftar dropdown. Masukkan **running**.

   1. Pilih **Simpan kondisi**.

   1. Dalam **aturan Default**, pilih **Go to end** untuk **langkah Default**.

1. Seret tindakan **Change an instance state** ke kotak **Drag action here** kosong di bawah **\$1\$1 GetInstanceState. InstanceState \$1\$1 == kondisi “berhenti”**.

   1. Untuk **nama Langkah**, masukkan**StartInstance**.

   1. Di tab **Inputs**, di bawah **Instance IDs**, pilih nilai input **InstanceId**dokumen dari dropdown.

   1. Untuk **status yang diinginkan**, tentukan **`running`**.

1. Seret aksi **Tunggu AWS sumber daya** ke kotak **Drag action here** kosong di bawah **\$1\$1 GetInstanceState. InstanceState \$1\$1 == kondisi “berhenti”**.

1. Untuk **nama Langkah**, masukkan nilai. Untuk tutorial ini, gunakan namanya`WaitForInstanceStop`.

   1. Untuk bidang **Layanan**, pilih **Amazon EC2**.

   1. Untuk bidang **API**, pilih **DescribeInstances**.

   1. Untuk bidang **pemilih Properti**, masukkan**\$1.Reservations[0].Instances[0].State.Name**.

   1. Untuk parameter **Nilai yang diinginkan**, masukkan**`["stopped"]`**.

   1. Di tab **Konfigurasi **WaitForInstanceStop****tindakan, pilih **StartInstance**dari **dropdown langkah Berikutnya**.

1. Seret **perintah Jalankan pada tindakan instance** ke kotak **Drag action here** kosong di bawah **\$1\$1 GetInstanceState. InstanceState \$1\$1 == kondisi “berjalan”**.

1. Untuk **nama Langkah**, masukkan**SayHello**.

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

   1. Untuk **InstanceIds**, pilih nilai input **InstanceId**dokumen dari dropdown.

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

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

1. Tinjau runbook yang sudah selesai di kanvas dan pilih **Create runbook** untuk menyimpan runbook tutorial.  
![\[Tinjau dan buat runbook.\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/images/visual_designer_tutorial_complete.png)

## Langkah 3: Tinjau kode yang dibuat secara otomatis
<a name="view-generated-code"></a>

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
<a name="use-tutorial-runbook"></a>

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/](https://console.aws.amazon.com/systems-manager/).

1. Di panel navigasi, pilih **Otomatisasi**, lalu pilih **Eksekusi otomatisasi**.

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

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

1. Pilih **Berikutnya**.

1. Di bagian **Execute Automation Runbook**, pilih **Eksekusi sederhana**.

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

1. (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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Jika alarm Anda aktif, otomatisasi dihentikan. Jika Anda menggunakan AWS CloudTrail, Anda akan melihat panggilan API di jejak Anda. 

1. Pilih **Eksekusi**. 

## Langkah 5: Bersihkan
<a name="cleanup-tutorial-runbook"></a>

**Untuk menghapus runbook Anda**

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

1. Di panel navigasi, pilih **Dokumen**.

1. Pilih tab **Dimiliki oleh saya**.

1. Temukan **VisualDesignExperienceTutorial**runbook.

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