• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola CloudWatch dasbor Amazon mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat [dokumentasi CloudWatch Dasbor Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal atau perbarui Distributor paket
Anda dapat menerapkan paket ke node AWS Systems Manager terkelola Anda dengan menggunakanDistributor, alat di AWS Systems Manager. Untuk menyebarkan paket, gunakan Konsol Manajemen AWS 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, alat di 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.
**penting**
Paket yang Anda instal menggunakan Distributor harus dihapus instalasinya hanya dengan menggunakan Distributor. Jika tidak, Systems Manager masih dapat mendaftarkan aplikasi sebagai `INSTALLED` dan mengarah ke hasil lain yang tidak diinginkan.
| Preferensi | AWS Systems Manager aksi | Info selengkapnya |
| --- | --- | --- |
| Instal atau perbarui paket segera. | Run Command | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Menginstal atau memperbarui paket menurut jadwal, sehingga instalasi selalu menyertakan versi default. | State Manager | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| 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](systems-manager-state-manager-targets-and-rate-controls.md). |
**Topics**
+ [Menginstal atau memperbarui paket satu kali menggunakan konsol](#distributor-deploy-pkg-console)
+ [Menjadwalkan instalasi paket atau pembaruan menggunakan konsol](#distributor-deploy-sm-pkg-console)
+ [Menginstal paket satu kali menggunakan AWS CLI](#distributor-deploy-pkg-cli)
+ [Memperbarui paket satu kali menggunakan AWS CLI](#distributor-update-pkg-cli)
+ [Menjadwalkan instalasi paket menggunakan AWS CLI](#distributor-smdeploy-pkg-cli)
+ [Menjadwalkan pembaruan paket menggunakan AWS CLI](#distributor-smupdate-pkg-cli)
## Menginstal atau memperbarui paket satu kali menggunakan konsol
Anda dapat menggunakan AWS Systems Manager konsol untuk menginstal atau memperbarui paket satu kali. Ketika Anda mengkonfigurasi instalasi satu kali, Distributor menggunakan[AWS Systems Manager Run Command](run-command.md), alat di AWS Systems Manager, untuk melakukan instalasi.
**Untuk menginstal atau memperbarui paket satu kali menggunakan konsol**
1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Di panel navigasi, pilih **Distributor**.
1. Di Distributor halaman beranda, pilih paket yang ingin Anda instal.
1. Pilih **Instal satu kali**.
Perintah ini terbuka Run Command dengan dokumen perintah `AWS-ConfigureAWSPackage` dan Distributor paket Anda sudah dipilih.
1. Untuk **Versi dokumen**, pilih versi dokumen `AWS-ConfigureAWSPackage` yang ingin Anda jalankan.
1. Untuk **Tindakan**, pilih **Instal**.
1. 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.
1. Untuk **Nama**, verifikasi bahwa nama paket yang Anda pilih telah dimasukkan.
1. (Opsional) Untuk **Versi**, masukkan nilai nama versi paket. Jika Anda membiarkan bidang ini kosong, Run Command instal versi default yang Anda pilih. Distributor
1. 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, lihat[Memecahkan masalah ketersediaan node terkelola](fleet-manager-troubleshooting-managed-nodes.md).
1. 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.
1. 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.
1. (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 instans (untuk instans EC2) atau peran layanan IAM (mesin yang diaktifkan hibrida) yang ditetapkan ke instance, bukan izin pengguna IAM yang melakukan tugas ini. Untuk informasi selengkapnya, lihat [Mengonfigurasi izin instans yang diperlukan untuk Systems Manager](setup-instance-permissions.md) atau [Membuat peran layanan IAM untuk lingkungan hibrid](hybrid-multicloud-service-role.md). Selain itu, jika bucket S3 yang ditentukan berbeda Akun AWS, pastikan bahwa profil instance atau peran layanan IAM yang terkait dengan node terkelola memiliki izin yang diperlukan untuk menulis ke bucket tersebut.
1. Di bagian **Notifikasi SNS**, jika Anda ingin notifikasi dikirim tentang status eksekusi perintah, pilih kotak centang **Aktifkan notifikasi SNS**.
Untuk informasi selengkapnya tentang mengonfigurasi notifikasi Run Command Amazon SNS, lihat. [Pemantauan perubahan status Systems Manager menggunakan notifikasi Amazon SNS](monitoring-sns-notifications.md)
1. Saat Anda siap menginstal paket, pilih **Jalankan**.
1. 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**.
1. Di area **Target dan output**, pilih tombol di sebelah nama node terkelola, lalu pilih **Lihat output**.
Halaman output perintah menampilkan hasil eksekusi perintah Anda.
1. (Opsional) Jika Anda memilih menulis output perintah ke bucket Amazon S3, pilih **Amazon S3** untuk melihat data log output.
## Menjadwalkan instalasi paket atau pembaruan menggunakan 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](systems-manager-state.md) untuk menginstal atau memperbarui.
**Untuk menjadwalkan instalasi paket menggunakan konsol**
1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Di panel navigasi, pilih **Distributor**.
1. Di Distributor halaman beranda, pilih paket yang ingin Anda instal atau perbarui.
1. Untuk **Paket** pilih **Instal menurut jadwal**.
Perintah ini terbuka State Manager untuk asosiasi baru yang dibuat untuk Anda.
1. Untuk **Nama** masukkan sebuah nama (misalnya, **Deploy-test-agent-package**). Ini memang opsional, tetapi direkomendasikan. Spasi tidak diperbolehkan dalam nama.
1. Pada daftar **Dokumen**, nama dokumen `AWS-ConfigureAWSPackage` telah dipilih.
1. Untuk **Tindakan**, verifikasi bahwa **Instal** telah dipilih.
1. 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.
1. Untuk **Nama**, verifikasi bahwa nama paket Anda dimasukkan.
1. Untuk **Versi**, jika Anda ingin menginstal versi paket selain versi terbaru yang dipublikasikan, masukkan pengenal versi.
1. 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**.
1. Untuk **Tentukan jadwal** pilih **Menurut Jadwal** untuk menjalankan asosiasi menurut jadwal reguler, atau **Tanpa Jadwal**untuk menjalankan asosiasi sekali. Untuk informasi selengkapnya tentang opsi ini, lihat [Bekerja dengan asosiasi di Systems Manager](state-manager-associations.md). Gunakan kontrol untuk membuat `cron` atau jadwal tingkat untuk asosiasi.
1. Pilih **Buat Asosiasi**.
1. 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](state-manager-associations.md) 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](state-manager-associations.md).
## Menginstal paket satu kali menggunakan 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 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 informasi tentang opsi lain yang dapat Anda gunakan dengan **send-command** perintah, lihat [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)di AWS Systems Manager bagian *Referensi AWS CLI Perintah*.
## Memperbarui paket satu kali menggunakan 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 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"]}'
```
Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan **send-command** perintah, lihat [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)di AWS Systems Manager bagian *Referensi AWS CLI Perintah*.
## Menjadwalkan instalasi paket menggunakan 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**
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 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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)di AWS Systems Manager bagian *Referensi AWS CLI Perintah*.
## Menjadwalkan pembaruan paket menggunakan 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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)di AWS Systems Manager bagian *Referensi AWS CLI Perintah*.