Instal atau perbarui Distributor paket

Untuk menginstal atau memperbarui paket satu kali menggunakan konsol

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

2. Di panel navigasi, pilih Distributor.

3. Pada Distributor beranda, pilih paket yang ingin Anda instal.

4. Pilih Instal satu kali.

   Perintah ini terbuka Run Command dengan dokumen perintah AWS-ConfigureAWSPackage dan Distributor paket yang sudah dipilih.

5. Untuk Versi dokumen, pilih versi dokumen AWS-ConfigureAWSPackage yang ingin Anda jalankan.

6. Untuk Tindakan, pilih Instal.

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

8. Untuk Nama, verifikasi bahwa nama paket yang Anda pilih telah dimasukkan.

9. (Opsional) Untuk Versi, masukkan nilai nama versi paket. Jika Anda membiarkan bidang ini kosong, Run Command menginstal versi default yang Anda pilih Distributor.

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

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

12. Untuk Rate Control:

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

13. (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.

14. 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 Amazon Run Command, lihat Pemantauan perubahan status Systems Manager menggunakan SNS notifikasi Amazon.

15. Saat Anda siap menginstal paket, pilih Jalankan.

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

17. Di area Target dan output, pilih tombol di sebelah nama node terkelola, lalu pilih Lihat output.

    Halaman output perintah menampilkan hasil eksekusi perintah Anda.

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

Untuk menjadwalkan instalasi paket menggunakan konsol

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

2. Di panel navigasi, pilih Distributor.

3. Pada Distributor beranda, pilih paket yang ingin Anda instal atau perbarui.

4. Untuk Paket pilih Instal menurut jadwal.

   Perintah ini terbuka State Manager ke asosiasi baru yang dibuat untuk Anda.

5. Untuk Nama masukkan sebuah nama (misalnya, Deploy-test-agent-package). Ini memang opsional, tetapi direkomendasikan. Spasi tidak diperbolehkan dalam nama.

6. Pada daftar Dokumen, nama dokumen AWS-ConfigureAWSPackage telah dipilih.

7. Untuk Tindakan, verifikasi bahwa Instal telah dipilih.

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

9. Untuk Nama, verifikasi bahwa nama paket Anda dimasukkan.

10. Untuk Versi, jika Anda ingin menginstal versi paket selain versi terbaru yang dipublikasikan, masukkan pengenal versi.

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

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

13. Pilih Buat Asosiasi.

14. Pada halaman Asosiasi, pilih tombol di sebelah asosiasi yang Anda buat, lalu pilih Terapkan asosiasi sekarang.

    State Manager membuat 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 menginstal paket satu kali menggunakan 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 memperbarui paket satu kali menggunakan 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"]}'