Systems Manager dokumen

DenganAWS Systems Manager, Anda memiliki visibilitas dan kontrol atas infrastruktur AndaAWS. Systems Manager menyediakan antarmuka pengguna terpadu yang dapat Anda gunakan untuk melihat data operasional dari beberapaLayanan AWS dan mengotomatisasi tugas-tugas operasional di seluruhAWS sumber daya Anda.

Dokumen Systems Manager (Systems) di instans terkelola Anda. Dokumen otomatisasi adalah jenis dokumen Systems Manager yang digunakan untuk melakukan tugas pemeliharaan dan penyebaran umum. Ini termasuk membuat atau memperbarui Amazon Machine (AMI). Topik ini menguraikan cara membuat, mengedit, dan menghapus dokumen otomatisasi denganAWS Toolkit.

Topik

• Asumsi dan prasyarat
• Izin IAM untuk Systems Manager
• Membuat dokumen otomatisasi Systems Manager baru
• Menerbitkan dokumen
• Mengedit dokumen otomatisasi Systems Manager yang ada
• Bekerja dengan versi
• Menghapus dokumen
• Menjalankan dokumen
• Memecahkan masalah dokumen otomatisasi Systems Manager diAWS Toolkit

Asumsi dan prasyarat

Sebelum memulai, pastikan Anda memenuhi persyaratan:

• Kau sudah familiar dengan Systems Manager. Untuk informasi selengkapnya, lihat Panduan Pengguna AWS Systems Manager.

• Anda sudah familiar dengan kasus penggunaan otomatisasi Systems Manager. Untuk informasi selengkapnya, lihat OtomatisasiAWS Systems Manager di PanduanAWS Systems Manager Pengguna.

Izin IAM untuk Systems Manager

Untuk membuat, mengedit, menerbitkan, dan menghapus dokumen otomatisasi Systems Manager, Anda harus memiliki profil kredensil yang berisi izinAWS Identity and Access Management (IAM) yang diperlukan. Dokumen kebijakan berikut mendefinisikan izin IAM yang diperlukan yang dapat digunakan dalam kebijakan utama.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:CreateDocument",
                "ssm:UpdateDocument",
                "ssm:UpdateDocumentDefaultVersion",
                "ssm:DeleteDocument"
            ],
            "Resource": "*"
        }
    ]
}

Untuk informasi tentang cara memperbarui kebijakan IAM, lihat Membuat kebijakan IAM di Panduan Pengguna IAM.

Membuat dokumen otomatisasi Systems Manager baru

Anda dapat membuat dokumen otomatisasi diJSON atauYAML menggunakanAWS Toolkit. Saat Anda membuat dokumen otomatisasi, dokumen tersebut disajikan dalam file tanpa judul. Anda dapat memberi nama file Anda dan menyimpannya. Namun, file tersebut tidak diunggahAWS hingga Anda mempublikasikannya.

Membuat dokumen otomatisasi baru

1. Pilih ikon pencarian di panel navigasi kiri atau tekan Ctrl+P untuk membuka panel Pencarian.

2. Di panel Pencarian, mulailah memasukkan istilah “manajer sistem” dan pilih perintah AWS: Buat Dokumen Systems Manager baru secara lokal saat ditampilkan.

3. Pilih salah satu template starter untuk contoh “Hello World”.

4. Pilih salah satuJSON atauYAML sebagai format untuk dokumen Anda.

   Editor menampilkan dokumen otomatisasi baru Anda.

catatan

Saat pertama kali membuat dokumen otomatisasi lokal, dokumen tersebut tidak muncul secara otomatisAWS. Sebelum Anda dapat menjalankannya, Anda harus mempublikasikannyaAWS.

Menerbitkan dokumen

Setelah Anda membuat atau mengedit dokumen otomatisasi Anda diAWS Toolkit, Anda dapat mempublikasikannyaAWS.

Untuk memublikasikan dokumen otomatisasi

1. Buka dokumen otomatisasi yang ingin Anda publikasikan menggunakan prosedur yang diuraikanMengedit dokumen otomatisasi Systems Manager yang ada.

2. Pilih ikon pencarian di panel navigasi kiri atau tekan Ctrl+P untuk membuka panel Pencarian.

3. Di panel Pencarian, mulailah memasukkan istilah “manajer sistem” dan pilih AWS: Publikasikan perintah Dokumen Systems Manager baru saat ditampilkan.

4. Untuk Langkah 1 dari 3, pilihWilayah AWS tempat Anda ingin mempublikasikan dokumen.

5. Untuk Langkah 2 dari 3, pilih Buat Cepat untuk membuat dokumen otomatisasi. Atau, pilih Pembaruan Cepat untuk memperbarui dokumen otomatisasi yang ada di Wilayah tersebut.

   catatan

   Anda hanya dapat memperbarui dokumen Jika Anda memilih Pembaruan Cepat dan Anda tidak memiliki dokumen apa pun di Wilayah tersebut, pesan akan memberi tahu Anda untuk mempublikasikan dokumen sebelum memperbaruinya.

6. Untuk Langkah 3 dari 3, tergantung pada pilihan Anda pada langkah sebelumnya, masukkan nama dokumen otomatisasi baru atau pilih dokumen yang ada untuk diperbarui.

   catatan

   Ketika Anda mempublikasikan pembaruan ke dokumen otomatisasi yang ada diAWS, versi baru ditambahkan ke dokumen. Jika dokumen memiliki beberapa versi, Anda dapat mengatur yang default.

Mengedit dokumen otomatisasi Systems Manager yang ada

Anda menggunakanAWS Explorer untuk menemukan dokumen otomatisasi Systems Manager yang ada. Ketika Anda membuka dokumen yang ada, itu muncul sebagai file tanpa judul diAWS Cloud9 editor. Ada tiga jenis dokumen

• Dimiliki oleh Amazon: Dokumen SSM yang telah dikonfigurasi sebelumnya yang dapat digunakan dengan menentukan parameter saat runtime.

• Dimiliki oleh saya: Dokumen yang telah saya buat dan terbitkanAWS.

• Dibagikan dengan saya: Dokumen yang telah dibagikan pemilik dengan Anda, berdasarkanAkun AWS ID Anda.

Satu-satunya jenis dokumen yang dapat Anda perbaruiAWS adalah dokumen yang dimiliki oleh saya. Anda juga dapat mengunduh dokumen otomatisasi yang dibagikan atau dimiliki oleh Amazon, dan mengeditnyaAWS Cloud9. Namun, ketika Anda mempublikasikan keAWS, Anda harus menggunakan baik membuat dokumen baru atau memperbarui dokumen yang ada Anda sendiri. Anda tidak dapat membuat versi baru dokumen yang memiliki pemilik lain atau dimiliki oleh Amazon.

Untuk informasi selengkapnya, lihat AWS Systems Managerdokumen di PanduanAWS Systems Manager Pengguna.

1. DiAWS Explorer, untuk Systems Manager, pilih kategori dokumen SSM yang ingin Anda unduh: Dimiliki oleh Amazon, Dimiliki oleh saya, atau Dibagikan dengan saya.

2. Untuk dokumen tertentu, buka menu konteks (klik kanan) dan pilih Unduh sebagai YAKL atau Unduh sebagai JSON.

   Dokumen SSM yang diformat ditampilkan di tab editor baru.

Setelah selesai mengedit, Anda dapat menggunakan perintah AWS: Publikasikan Dokumen Systems Manager baru untuk membuat dokumen baru diAWS Cloud atau memperbarui dokumen yang ada yang Anda miliki.

Bekerja dengan versi

Dokumen otomatisasi Systems Manager menggunakan versi untuk manajemen perubahan. DenganAWS Toolkit, Anda dapat mengatur versi default dokumen, yang merupakan versi yang digunakan saat Anda menjalankan dokumen.

Untuk mengatur versi default

• DiAWS Explorer, arahkan ke dokumen yang ingin Anda atur, buka menu konteks (klik kanan) untuk dokumen, dan pilih Atur versi defaultnya.

  catatan

  Jika dokumen yang dipilih hanya memiliki satu versi, Anda tidak dapat mengubah defaultnya.

Menghapus dokumen

Anda dapat menghapus dokumen otomatisasi yang Anda miliki diAWS Toolkit. Menghapus dokumen Otomasi menghapus dokumen dan semua versi dokumen.

penting

• Menghapus adalah tindakan destruktif yang tidak dapat dibatalkan.

• Menghapus dokumen otomatisasi yang telah dimulai tidak menghapusAWS sumber daya yang dibuat atau dimodifikasi saat dijalankan.

• Menghapus hanya diizinkan jika Anda memiliki dokumen.

Menghapus dokumen otomatisasi

1. Di panelAWS Explorer, untuk Systems Manager, luaskan Dimiliki oleh Saya untuk mencantumkan dokumen Anda.

2. Buka menu konteks (klik kanan) untuk dokumen yang ingin Anda hapus, lalu pilih Hapus dokumen.

3. Di kotak dialog peringatan yang ditampilkan, pilih Hapus untuk mengonfirmasi.

Menjalankan dokumen

Setelah dokumen otomatisasi Anda dipublikasikanAWS, Anda dapat menjalankannya untuk melakukan tugas atas nama Anda di AndaAkun AWS. Untuk menjalankan dokumen Otomasi AndaAWS Management Console, Anda menggunakan, API Systems ManagerAWS CLI,, atauAWS Tools for PowerShell. Untuk petunjuk tentang cara menjalankan dokumen otomatisasi, lihat Menjalankan otomatisasi sederhana di PanduanAWS Systems Manager Pengguna.

Atau, jika Anda ingin menggunakan salah satuAWS SDK dengan Systems Manager API untuk menjalankan dokumen Automation, lihat referensiAWS SDK.

penting

Menjalankan dokumen otomatisasi dapat membuat sumber daya baruAWS dan dapat dikenakan biaya penagihan. Kami sangat menyarankan agar Anda memahami apa dokumen otomatisasi Anda akan dibuat di akun Anda sebelum Anda menjalankannya.