Menginstal atau memperbarui paket satu kali (konsol)Penjadwalan instalasi atau pembaruan paket (konsol)Menginstal paket satu kali (AWS CLI)Memperbarui paket satu kali (AWS CLI)Menjadwalkan instalasi paket (AWS CLI)Menjadwalkan pembaruan paket (AWS CLI)

Menginstal atau memperbarui paket

Anda dapat menerapkan paket ke node AWS Systems Manager terkelola Anda dengan menggunakanDistributor, kemampuan. AWS Systems Manager Untuk menyebarkan paket, gunakan AWS Management Console atau AWS Command Line Interface (AWS CLI). Anda dapat men-deploy satu versi dari satu paket per perintah. Anda dapat menginstal paket baru atau memperbarui instalasi yang ada di tempat. Anda dapat memilih untuk menggunakan versi tertentu atau memilih untuk selalu men-deploy versi terbaru paket untuk deployment. Kami merekomendasikan menggunakanState Manager, kemampuan AWS Systems Manager, untuk menginstal paket. Menggunakan State Manager membantu memastikan bahwa node terkelola Anda selalu menjalankan sebagian besar up-to-date versi paket Anda.

Preferensi	AWS Systems Manager aksi	Info selengkapnya
Instal atau perbarui paket segera.	Run Command	Menginstal atau memperbarui paket satu kali (konsol) Menginstal paket satu kali (AWS CLI) Memperbarui paket satu kali (AWS CLI)
Menginstal atau memperbarui paket menurut jadwal, sehingga instalasi selalu menyertakan versi default.	State Manager	Penjadwalan instalasi atau pembaruan paket (konsol) Menjadwalkan instalasi paket (AWS CLI) Menjadwalkan pembaruan paket (AWS CLI)
Instal paket secara otomatis pada node terkelola baru yang memiliki tag atau kumpulan tag tertentu. Misalnya, menginstal CloudWatch agen Amazon pada instance baru.	State Manager	Salah satu cara untuk melakukannya adalah dengan menerapkan tag ke node terkelola baru, lalu tentukan tag sebagai target dalam State Manager asosiasi Anda. State Managersecara otomatis menginstal paket dalam asosiasi pada node terkelola yang memiliki tag yang cocok. Lihat Memahami target dan kontrol tingkat dalam State Manager asosiasi.

Topik

Menginstal atau memperbarui paket satu kali (konsol)
Penjadwalan instalasi atau pembaruan paket (konsol)
Menginstal paket satu kali (AWS CLI)
Memperbarui paket satu kali (AWS CLI)
Menjadwalkan instalasi paket (AWS CLI)
Menjadwalkan pembaruan paket (AWS CLI)

Menginstal atau memperbarui paket satu kali (konsol)

Anda dapat menggunakan AWS Systems Manager konsol untuk menginstal atau memperbarui paket satu kali. Ketika Anda mengkonfigurasi instalasi satu kaliAWS Systems Manager Run Command, Distributor menggunakan, kemampuan AWS Systems Manager, untuk melakukan instalasi.

Untuk menginstal atau memperbarui paket satu kali (konsol)

Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/.
Di panel navigasi, pilih Distributor.
Di Distributor halaman beranda, pilih paket yang ingin Anda instal.
Pilih Instal satu kali.

Perintah ini terbuka Run Command dengan dokumen perintah AWS-ConfigureAWSPackage dan Distributor paket Anda sudah dipilih.
Untuk Versi dokumen, pilih versi dokumen AWS-ConfigureAWSPackage yang ingin Anda jalankan.
Untuk Tindakan, pilih Instal.
Untuk Jenis Instalasi, pilih salah satu dari berikut ini:
- Menghapus instalasi dan instalasi ulang: Paket benar-benar dihapus instalasinya, dan kemudian diinstal ulang. Aplikasi ini tidak tersedia sampai instalasi ulang selesai.
- Pembaruan di tempat: Hanya file baru atau diubah ditambahkan ke instalasi yang ada sesuai dengan petunjuk yang Anda berikan dalam skrip update. Aplikasi tetap tersedia selama proses pembaruan. Opsi ini tidak didukung untuk paket yang AWS diterbitkan kecuali AWSEC2Launch-Agent paket.
Untuk Nama, verifikasi bahwa nama paket yang Anda pilih telah dimasukkan.
(Opsional) Untuk Versi, masukkan nilai nama versi paket. Jika Anda membiarkan bidang ini kosong, Run Command instal versi default yang Anda pilih. Distributor
Di bagian Target, pilih node terkelola tempat Anda ingin menjalankan operasi ini dengan menentukan tag, memilih instance atau perangkat secara manual, atau dengan menentukan grup sumber daya.

catatan
Jika Anda tidak melihat node terkelola dalam daftar, lihatMemecahkan masalah ketersediaan node terkelola.
Untuk Parameter lainnya:
- Untuk Komentar, ketik informasi tentang perintah ini.
- Untuk Waktu habis (detik), tentukan jumlah detik untuk menunggu sistem sebelum gagal menjalankan perintah keseluruhan.
Untuk Kontrol Tingkat:
- Untuk Konkurensi, tentukan angka atau persentase target untuk menjalankan perintah pada saat yang bersamaan.
  
  catatan
  Jika Anda memilih target dengan menentukan tag atau grup sumber daya dan Anda tidak yakin berapa banyak node terkelola yang ditargetkan, maka batasi jumlah target yang dapat menjalankan dokumen pada saat yang sama dengan menentukan persentase.
- Untuk ambang kesalahan, tentukan kapan harus berhenti menjalankan perintah pada target lain setelah gagal pada angka atau persentase node terkelola. Misalnya, jika Anda menentukan tiga kesalahan, Systems Manager berhenti mengirim perintah ketika kesalahan keempat diterima. Node terkelola yang masih memproses perintah mungkin juga mengirim kesalahan.
(Opsional) Untuk Opsi output, untuk menyimpan output perintah ke file, pilih kotak Tuliskan output perintah ke bucket S3. Masukkan nama bucket dan prefiks (folder) di kotak.

catatan
Izin S3 yang memberikan kemampuan untuk menulis data ke bucket S3 adalah izin profil instance (untuk EC2 instance) atau peran IAM layanan (mesin yang diaktifkan hibrida) yang ditetapkan ke instance, bukan izin pengguna yang melakukan tugas ini. IAM Untuk informasi selengkapnya, lihat Mengonfigurasi izin instans yang diperlukan untuk Systems Manager atau Membuat peran IAM layanan untuk lingkungan hibrid. Selain itu, jika bucket S3 yang ditentukan berbeda Akun AWS, pastikan bahwa profil instance atau peran IAM layanan yang terkait dengan node terkelola memiliki izin yang diperlukan untuk menulis ke bucket tersebut.
Di bagian SNSnotifikasi, jika Anda ingin pemberitahuan dikirim tentang status eksekusi perintah, pilih kotak centang Aktifkan SNS pemberitahuan.

Untuk informasi selengkapnya tentang mengonfigurasi SNS notifikasi AmazonRun Command, lihatPerubahan status Monitoring Systems Manager menggunakan SNS notifikasi Amazon.
Saat Anda siap menginstal paket, pilih Jalankan.
Area Status perintah melaporkan kemajuan eksekusi. Jika perintah masih berlangsung, pilih ikon segarkan di pojok kiri atas konsol sampai kolom Status keseluruhan atau Status terperinci menampilkan Sukses atau Gagal.
Di area Target dan output, pilih tombol di sebelah nama node terkelola, lalu pilih Lihat output.

Halaman output perintah menampilkan hasil eksekusi perintah Anda.
(Opsional) Jika Anda memilih menulis output perintah ke bucket Amazon S3, pilih Amazon S3 untuk melihat data log output.

Penjadwalan instalasi atau pembaruan paket (konsol)

Anda dapat menggunakan AWS Systems Manager konsol untuk menjadwalkan instalasi atau pembaruan paket. Saat Anda menjadwalkan instalasi atau pembaruan paket, Distributor gunakan AWS Systems Manager State Manager untuk menginstal atau memperbarui.

Untuk menjadwalkan instalasi paket (konsol)

Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/.
Di panel navigasi, pilih Distributor.
Di Distributor halaman beranda, pilih paket yang ingin Anda instal atau perbarui.
Untuk Paket pilih Instal menurut jadwal.

Perintah ini terbuka State Manager untuk asosiasi baru yang dibuat untuk Anda.
Untuk Nama masukkan sebuah nama (misalnya, Deploy-test-agent-package). Ini memang opsional, tetapi direkomendasikan. Spasi tidak diperbolehkan dalam nama.
Pada daftar Dokumen, nama dokumen AWS-ConfigureAWSPackage telah dipilih.
Untuk Tindakan, verifikasi bahwa Instal telah dipilih.
Untuk Jenis instalasi, lakukan hal berikut:
- Menghapus instalasi dan instalasi ulang: Paket benar-benar dihapus instalasinya, dan kemudian diinstal ulang. Aplikasi ini tidak tersedia sampai instalasi ulang selesai.
- Pembaruan di tempat: Hanya file baru atau diubah ditambahkan ke instalasi yang ada sesuai dengan petunjuk yang Anda berikan dalam skrip update. Aplikasi tetap tersedia selama proses pembaruan.
Untuk Nama, verifikasi bahwa nama paket Anda dimasukkan.
Untuk Versi, jika Anda ingin menginstal versi paket selain versi terbaru yang dipublikasikan, masukkan pengenal versi.
Untuk Target pilih Memilih semua instans terkelola di akun ini, Menentukan tanda, atau Memilih Instans Secara Manual. Jika Anda menargetkan sumber daya dengan menggunakan tanda, masukkan kunci tanda dan nilai tanda di kolom yang disediakan.

catatan
Anda dapat memilih perangkat AWS IoT Greengrass inti terkelola dengan memilih memilih semua instans terkelola di akun ini atau Memilih Instans Secara Manual.
Untuk Tentukan jadwal pilih Menurut Jadwal untuk menjalankan asosiasi menurut jadwal reguler, atau Tanpa Jadwaluntuk menjalankan asosiasi sekali. Untuk informasi selengkapnya tentang opsi ini, lihat Bekerja dengan asosiasi di Systems Manager. Gunakan kontrol untuk membuat cron atau jadwal tingkat untuk asosiasi.
Pilih Buat Asosiasi.
Pada halaman Asosiasi, pilih tombol di sebelah asosiasi yang Anda buat, lalu pilih Terapkan asosiasi sekarang.

State Managermembuat dan segera menjalankan asosiasi pada target yang ditentukan. Untuk informasi selengkapnya tentang hasil asosiasi yang berjalan, lihat Bekerja dengan asosiasi di Systems Manager dalam panduan ini.

Untuk informasi selengkapnya tentang bekerja dengan opsi di Opsi lanjutan, Pengendalian rate, dan Opsi output, lihat Bekerja dengan asosiasi di Systems Manager.

Menginstal paket satu kali (AWS CLI)

Anda dapat menjalankan send-command AWS CLI untuk menginstal Distributor paket satu kali. Jika paket sudah terinstal, aplikasi akan diambil secara offline saat paket dihapus instalasinya dan versi baru diinstal di tempatnya.

Untuk menginstal paket satu kali (AWS CLI)

Jalankan perintah berikut di AWS CLI.


aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "instance-IDs" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

catatan

Perilaku default untuk installationType adalah Uninstall and reinstall. Anda dapat menghilangkan "installationType":["Uninstall and reinstall"] dari perintah ini ketika Anda menginstal paket lengkap.

Berikut adalah contohnya.


aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "i-00000000000000" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'

Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan send-command perintah, lihat send-commanddi AWS Systems Manager bagian Referensi AWS CLI Perintah.

Memperbarui paket satu kali (AWS CLI)

Anda dapat menjalankan send-command AWS CLI untuk memperbarui Distributor paket tanpa membuat aplikasi terkait offline. Hanya file baru atau yang diperbarui dalam paket yang diganti.

Untuk memperbarui paket satu kali (AWS CLI)

Jalankan perintah berikut di AWS CLI.


aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "instance-IDs" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

catatan

Ketika Anda menambahkan file baru atau yang diubah, Anda harus menyertakan "installationType":["In-place update"] dalam perintah.

Berikut adalah contohnya.


aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "i-02573cafcfEXAMPLE" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'

Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan send-command perintah, lihat send-commanddi AWS Systems Manager bagian Referensi AWS CLI Perintah.

Menjadwalkan instalasi paket (AWS CLI)

Anda dapat menjalankan create-association AWS CLI untuk menginstal Distributor paket sesuai jadwal. Nilai --name, nama dokumen, selalu AWS-ConfigureAWSPackage. Perintah berikut menggunakan kunci InstanceIds untuk menentukan target node terkelola. Jika paket sudah terinstal, aplikasi akan diambil secara offline saat paket dihapus instalasinya dan versi baru diinstal di tempatnya.


aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

catatan

Berikut adalah contohnya.


aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan create-association perintah, lihat create-associationdi AWS Systems Manager bagian Referensi AWS CLI Perintah.

Menjadwalkan pembaruan paket (AWS CLI)

Anda dapat menjalankan create-association AWS CLI untuk memperbarui Distributor paket sesuai jadwal tanpa membuat aplikasi terkait offline. Hanya file baru atau yang diperbarui dalam paket yang diganti. Nilai --name, nama dokumen, selalu AWS-ConfigureAWSPackage. Perintah berikut menggunakan kunci InstanceIds untuk menentukan instans target.


aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

catatan

Ketika Anda menambahkan file baru atau yang diubah, Anda harus menyertakan "installationType":["In-place update"] dalam perintah.

Berikut adalah contohnya.


aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan create-association perintah, lihat create-associationdi AWS Systems Manager bagian Referensi AWS CLI Perintah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menambahkan versi paket

Menghapus instalasi paket.