View a markdown version of this page

Bekerja dengan dokumen Otomasi Manajer Sistem - AWS Toolkit for VS Code
Asumsi dan prasyaratIzin IAM untuk dokumen Otomasi Manajer SistemMembuat dokumen Otomasi Manajer Sistem baruMembuka dokumen Otomasi Manajer Sistem yang adaMengedit dokumen Otomasi Manajer SistemMenerbitkan dokumen Otomasi Manajer SistemMenghapus dokumen Otomasi Manajer SistemMenjalankan dokumen Otomasi Manajer Sistem

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

Bekerja dengan dokumen Otomasi Manajer Sistem

AWS Systems Manager memberi Anda visibilitas dan kontrol infrastruktur Anda AWS. Manajer Sistem menyediakan antarmuka pengguna terpadu sehingga Anda dapat melihat data operasional dari beberapa AWS layanan dan mengotomatiskan tugas operasional di seluruh AWS sumber daya Anda.

Dok umen Manajer Sistem mendefinisikan tindakan yang dilakukan Manajer Sistem pada instans terkelola Anda. Dokumen Otomasi adalah jenis dokumen Manajer Sistem yang Anda gunakan untuk melakukan tugas pemeliharaan dan penerapan umum seperti membuat atau memperbarui Amazon Machine Image (AMI). Topik ini menguraikan cara membuat, mengedit, menerbitkan, dan menghapus dokumen Otomasi dengan AWS Toolkit for Visual Studio Code.

Topik

Asumsi dan prasyarat

Sebelum memulai, pastikan:

  • Anda telah menginstal Visual Studio Code dan versi terbaru dari AWS Toolkit for Visual Studio Code. Untuk informasi selengkapnya, lihat Memasang AWS Toolkit for Visual Studio Code.

  • Anda akrab dengan Manajer Sistem. Untuk informasi selengkapnya, silakan lihat Panduan Pengguna AWS Systems Manager .

  • Anda terbiasa dengan kasus penggunaan Otomasi Manajer Sistem. Untuk informasi selengkapnya, lihat Otomatisasi Manajer AWS Sistem di Panduan AWS Systems Manager Pengguna.

Izin IAM untuk dokumen Otomasi Manajer Sistem

Dalam Toolkit untuk Kode VS Anda harus memiliki profil kredenSIAL yang berisi izin AWS Identity and Access Management (IAM) yang diperlukan untuk membuat, mengedit, menerbitkan, dan menghapus dokumen Otomasi Manajer Sistem. Dokumen kebijakan berikut mendefinisikan izin IAM yang diperlukan yang dapat digunakan dalam kebijakan utama:

JSON
{
    "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. Untuk informasi tentang cara mengatur profil kredenSIAL Anda, lihatAWS Kredensial IAM.

Membuat dokumen Otomasi Manajer Sistem baru

Anda dapat membuat dokumen Otomasi baru di JSON atau YAML menggunakan Visual Studio Code. Saat Anda membuat dokumen Otomasi baru, itu akan disajikan dalam file tanpa judul. Anda dapat memberi nama file Anda dan menyimpannya di VS Code, namun nama file tidak terlihat AWS.

Untuk membuat dokumen Otomasi baru

  1. Buka Kode VS.

  2. Pada menu View, pilih Command Palette untuk membuka Command Palette.

  3. Di Palette Perintah, masukkan AWS Toolkit Buat Dokumen Manajer Sistem baru secara Lok al.

  4. Pilih salah satu template pemula untuk contoh Hello World.

  5. Pilih salah satu JSON atauYAML.

    Dokumen Otomasi baru dibuat.

catatan

Dokumen Otomasi baru Anda di VS Code tidak secara otomatis muncul di AWS. Anda harus mempublikasikannya AWS sebelum Anda dapat menjalankannya.

Membuka dokumen Otomasi Manajer Sistem yang ada

Anda menggunakan AWS Explorer untuk menemukan dokumen Otomasi Manajer Sistem yang ada. Saat Anda membuka dokumen Otomasi yang ada, dokumen tersebut muncul sebagai file tanpa judul di VS Code.

Untuk membuka dokumen Otomasi

  1. Buka Kode VS.

  2. Dari navigasi sebelah kiri, pilih AWS untuk membuka AWS Explorer.

  3. Di AWS Explorer, untuk Manajer Sistem, pilih ikon unduhan pada dokumen yang ingin Anda buka dan kemudian pilih versi dokumen. File akan terbuka dalam format untuk versi itu. Jika tidak, pilih Unduh sebagai JSON atau Unduh sebagai YAML.

catatan

Menyimpan dokumen Otomasi secara lokal sebagai file di VS Code tidak membuatnya muncul di AWS. Itu perlu dipublikasikan AWS sebelum dieksekusi.

Mengedit dokumen Otomasi Manajer Sistem

Jika Anda memiliki dokumen Otomasi apa pun, dokumen tersebut muncul di kategori Dim iliki oleh Saya dari dokumen Manajer Sistem di AWS Explorer. Anda dapat memiliki dokumen Otomasi yang sudah ada di AWS, dan Anda dapat memiliki dokumen baru atau yang diperbarui yang sebelumnya Anda publikasikan AWS dari VS Code.

Saat Anda membuka dokumen Otomasi untuk diedit di VS Code, Anda dapat melakukan lebih banyak dengannya daripada yang Anda bisa di Konsol Manajemen AWS. Contoh:

  • Ada validasi skema pada keduanya JSON dan YAML format.

  • Ada cuplikan yang tersedia di editor dokumen bagi Anda untuk membuat salah satu jenis langkah otomatisasi.

  • Ada dukungan pelengkapan otomatis pada berbagai opsi di JSON danYAML.

Bekerja dengan versi

Dokumen Sistem Manajer Otomasi menggunakan versi untuk manajemen perubahan. Anda dapat memilih versi default untuk dokumen Otomasi di VS Code.

Untuk mengatur versi default

  • Di AWS Explorer, arahkan ke dokumen yang ingin Anda atur versi default, buka menu konteks (klik kanan) untuk dokumen, dan pilih Tet apkan versi default.

    catatan

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

Menerbitkan dokumen Otomasi Manajer Sistem

Setelah mengedit dokumen Otomasi di VS Code, Anda dapat mempublikasikannya ke AWS.

Untuk menerbitkan dokumen Otomasi Anda

  1. Buka dokumen Otomasi yang ingin Anda publikasikan menggunakan prosedur yang diuraikan dalamMembuka dokumen Otomasi Manajer Sistem yang ada.

  2. Buat perubahan yang ingin Anda publikasikan. Untuk informasi selengkapnya, lihat Mengedit dokumen Otomasi Manajer Sistem.

  3. Di kanan atas file yang terbuka, pilih ikon unggah.

  4. Di kotak dialog alur kerja penerbitan, pilih Wil AWS ayah tempat Anda ingin menerbitkan dokumen Otomasi.

  5. Jika Anda menerbitkan dokumen baru, pilih Buat Cepat. Jika tidak, pilih Pembaruan C epat untuk memperbarui dokumen Otomasi yang ada di Wil AWS ayah tersebut.

  6. Masukkan nama untuk dokumen Otomasi ini.

Saat Anda menerbitkan pembaruan ke dokumen Otomasi yang ada ke AWS, versi baru ditambahkan ke dokumen.

Menghapus dokumen Otomasi Manajer Sistem

Anda dapat menghapus dokumen Otomasi di VS Code. Menghapus dokumen Otomasi menghapus dokumen dan semua versi dokumen.

penting

  • Menghapus adalah tindakan destruktif yang tidak dapat dibatalkan.

  • Menghapus dokumen Otomasi yang telah dijalankan tidak menghapus AWS sumber daya yang dibuat atau dimodifikasi saat dimulai.

Untuk menghapus dokumen Otomasi Anda

  1. Buka Kode VS.

  2. Dari navigasi sebelah kiri, pilih AWS untuk membuka AWS Explorer.

  3. Di AWS Explorer, untuk Manajer Sistem, buka menu konteks (klik kanan) untuk dokumen yang ingin Anda hapus, dan pilih H apus dokumen.

Menjalankan dokumen Otomasi Manajer Sistem

Setelah dokumen Otomasi dipublikasikan ke AWS, Anda dapat menjalankannya untuk melakukan tugas atas nama Anda di AWS akun Anda. Untuk menjalankan dokumen Otomasi Anda Konsol Manajemen AWS, Anda menggunakan, API Manajer Sistem AWS CLI, atau Alat AWS untuk PowerShell. Untuk petunjuk tentang cara menjalankan dokumen Otomasi, lihat Men jalankan otomatisasi sederhana di Panduan AWS Systems Manager Pengguna.

Atau, jika Anda ingin menggunakan salah satu AWS SDK dengan API Manajer Sistem untuk menjalankan dokumen Otomasi Anda, lihat referensi AWS SDK.

catatan

Menjalankan dokumen Otomasi dapat membuat sumber daya baru AWS dan dapat menimbulkan biaya penagihan. Kami sangat menyarankan Anda memahami apa yang akan dibuat dokumen Otomasi Anda di akun Anda sebelum Anda memulainya.