Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bekerja dengan dokumen
Bagian ini mencakup informasi tentang cara menggunakan dan bekerja dengan SSM dokumen.
Daftar Isi
Menggunakan SSM dokumen di State Manager Asosiasi
Jika Anda membuat SSM dokumen untuk State Manager, kemampuan AWS Systems Manager, Anda harus mengaitkan dokumen dengan instance terkelola Anda setelah Anda menambahkan dokumen ke sistem. Untuk informasi selengkapnya, lihat Bekerja dengan asosiasi di Systems Manager.
Ingatlah detail berikut saat menggunakan SSM dokumen di State Manager asosiasi.
-
Anda dapat menetapkan beberapa dokumen ke target dengan membuat yang berbeda State Manager asosiasi yang menggunakan dokumen yang berbeda.
-
Jika Anda membuat dokumen dengan plugin yang berlawanan (misalnya, domain bergabung dan menghapus dari domain), plugin terakhir akan jalankan sebagai status akhir. State Manager tidak memvalidasi urutan logis atau rasionalitas perintah atau plugin dalam dokumen Anda.
-
Ketika memproses dokumen, asosiasi instans diterapkan pertama kali, dan asosiasi grup yang ditandai diterapkan berikutnya. Jika instans adalah bagian dari beberapa kelompok yang ditandai, maka dokumen yang merupakan bagian dari kelompok yang ditandai tidak akan dijalankan dalam urutan tertentu. Jika instans langsung ditargetkan melalui beberapa dokumen dengan ID instans nya, tidak ada urutan tertentu pada eksekusi.
-
Jika Anda mengubah versi default dokumen SSM Kebijakan untuk State Manager, asosiasi apa pun yang menggunakan dokumen akan mulai menggunakan versi default baru saat Systems Manager menerapkan asosiasi ke instance berikutnya.
-
Jika Anda membuat asosiasi menggunakan SSM dokumen yang dibagikan dengan Anda, dan kemudian pemilik berhenti berbagi dokumen dengan Anda, asosiasi Anda tidak lagi memiliki akses ke dokumen itu. Namun, jika pemilik berbagi SSM dokumen yang sama dengan Anda lagi nanti, asosiasi Anda secara otomatis memetakan ulang dokumen tersebut.
Membandingkan versi SSM dokumen
Anda dapat membandingkan perbedaan konten antara versi AWS Systems Manager (SSM) dokumen di konsol Systems Manager Documents. Saat membandingkan versi SSM dokumen, perbedaan antara konten versi disorot.
Untuk membandingkan konten SSM dokumen (konsol)
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Dalam daftar dokumen, pilih dokumen yang kontennya ingin Anda bandingkan.
-
Pada tab Konten, pilih Bandingkan versi, dan pilih versi dokumen yang ingin Anda bandingkan kontennya.
Buat SSM dokumen (konsol)
Setelah membuat konten untuk SSM dokumen kustom Anda, seperti yang dijelaskan dalamMenulis konten SSM dokumen, Anda dapat menggunakan konsol Systems Manager untuk membuat SSM dokumen menggunakan konten Anda.
Untuk membuat SSM dokumen (konsol)
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Pilih Buat perintah atau sesi.
-
Masukkan nama deskriptif untuk dokumen
-
(Opsional) Untuk Jenis target, tentukan jenis sumber daya dokumen yang dapat dijalankan.
-
Di daftar Jenis dokumen, pilih jenis dokumen yang ingin Anda buat.
-
Hapus tanda kurung di bidang Konten, dan kemudian paste dokumen konten yang Anda buat sebelumnya.
-
(Opsional) Dalam bagian Tag dokumen, terapkan satu pasangan nilai kunci tag atau lebih ke dokumen.
Tag adalah metadata opsional yang Anda tetapkan ke sumber daya. Tag memungkinkan Anda untuk mengkategorikan sumber daya dengan berbagai cara, seperti berdasarkan tujuan, pemilik, atau lingkungan. Misalnya, Anda mungkin ingin menandai dokumen untuk mengidentifikasi jenis tugas yang dijalankannya, jenis sistem operasi target, dan lingkungan tempat ia berjalan. Dalam kasus ini, Anda bisa menentukan pasangan nama/nilai kunci berikut:
-
Key=TaskType,Value=MyConfigurationUpdate
-
Key=OS,Value=AMAZON_LINUX_2
-
Key=Environment,Value=Production
-
-
Pilih Buat dokumen untuk menyimpan dokumen.
Buat SSM dokumen (baris perintah)
Setelah Anda membuat konten untuk dokumen kustom AWS Systems Manager (SSM), seperti yang dijelaskan dalamMenulis konten SSM dokumen, Anda dapat menggunakan AWS Command Line Interface (AWS CLI) atau AWS Tools for PowerShell untuk membuat SSM dokumen menggunakan konten Anda. Hal ini ditunjukkan dalam perintah berikut.
Sebelum Anda mulai
Instal dan konfigurasikan AWS CLI atau AWS Tools for PowerShell, jika Anda belum melakukannya. Untuk selengkapnya, lihat Menginstal atau memperbarui versi terbaru AWS CLI dan Menginstal AWS Tools for PowerShell.
Jalankan perintah berikut. Ganti masing-masing example resource
placeholder
dengan informasi Anda sendiri.
Jika berhasil, sistem menampilkan respon seperti berikut ini.
{ "DocumentDescription":{ "CreatedDate":1.585061751738E9, "DefaultVersion":"1", "Description":"MyCustomDocument", "DocumentFormat":"JSON", "DocumentType":"Command", "DocumentVersion":"1", "Hash":"0d3d879b3ca072e03c12638d0255ebd004d2c65bd318f8354fcde820dEXAMPLE", "HashType":"Sha256", "LatestVersion":"1", "Name":"Example", "Owner":"111122223333", "Parameters":[ --truncated-- ], "PlatformTypes":[ "Windows", "Linux" ], "SchemaVersion":"0.3", "Status":"Creating", "Tags": [ { "Key": "Purpose", "Value": "Test" } ] } }
Buat SSM dokumen (API)
Setelah Anda membuat konten untuk dokumen kustom AWS Systems Manager (SSM) Anda, seperti yang dijelaskan dalamMenulis konten SSM dokumen, Anda dapat menggunakan pilihan Anda SDK untuk memanggil AWS Systems Manager CreateDocumentAPIoperasi untuk membuat SSM dokumen menggunakan konten Anda. YAMLString JSON atau untuk parameter Content
permintaan umumnya dibaca dari file. Contoh fungsi berikut membuat SSM dokumen menggunakan SDKs untuk Python, Go, dan Java.
Untuk informasi selengkapnya tentang membuat konten dokumen kustom, lihat Elemen dan parameter data.
Menghapus dokumen khusus SSM
Jika Anda tidak lagi ingin menggunakan SSM dokumen kustom, Anda dapat menghapusnya dengan menggunakan AWS Command Line Interface (AWS CLI) atau AWS Systems Manager konsol.
Untuk menghapus SSM dokumen (AWS CLI)
-
Sebelum Anda menghapus dokumen, kami sarankan Anda memisahkan semua instance yang terkait dengan dokumen.
Jalankan perintah berikut untuk memisahkan instance dari dokumen.
aws ssm delete-association --instance-id "123456789012" --name "
documentName
"Tidak ada output jika perintah berhasil.
-
Jalankan perintah berikut. Ganti masing-masing
example resource placeholder
dengan informasi Anda sendiri.Tidak ada output jika perintah berhasil.
penting
Jika
document-version
atau tidakversion-name
disediakan, semua versi dokumen dihapus.
Untuk menghapus SSM dokumen (konsol)
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Pilih dokumen yang ingin Anda hapus.
-
Pilih Hapus. Saat diminta untuk menghapus dokumen, pilih Hapus.