• 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.
# Tambahkan versi ke Distributor paket
Untuk menambahkan versi paket, [buat paket](distributor-working-with-packages-create.md), lalu gunakan Distributor untuk menambahkan versi paket dengan menambahkan entri ke dokumen AWS Systems Manager (SSM) yang sudah ada untuk versi yang lebih lama. Distributoradalah alat di AWS Systems Manager. Untuk menghemat waktu, perbarui manifes untuk versi paket yang lebih lama, ubah nilai entri `version` dalam manifes (sebagai contoh, dari `Test_1.0` ke `Test_2.0`) dan simpan sebagai manifes untuk versi baru. Alur kerja **Tambahkan versi** sederhana di Distributor konsol memperbarui file manifes untuk Anda.
Versi paket baru dapat:
+ Ganti setidaknya satu file yang dapat diinstal yang terlampir ke versi saat ini.
+ Tambahkan file baru yang dapat diinstal untuk mendukung platform tambahan.
+ Hapus file untuk menghentikan dukungan untuk platform tertentu.
Versi yang lebih baru dapat menggunakan bucket Amazon Simple Storage Service (Amazon S3) yang sama, tetapi harus memiliki URL dengan nama file yang berbeda ditampilkan di bagian akhir. Anda dapat menggunakan konsol Systems Manager atau AWS Command Line Interface (AWS CLI) untuk menambahkan versi baru. Mengunggah file yang dapat diinstal dengan nama yang tepat sama seperti file yang dapat diinstal yang ada di bucket Amazon S3 akan menimpa file yang ada. File yang dapat diinstal tidak akan disalin dari versi lama ke versi baru; Anda harus mengunggah file yang dapat diinstal dari versi lama agar mereka menjadi bagian dari versi baru. Setelah Distributor selesai membuat versi paket baru, Anda dapat menghapus atau menggunakan kembali bucket Amazon S3, Distributor karena menyalin perangkat lunak Anda ke bucket Systems Manager internal sebagai bagian dari proses pembuatan versi.
**catatan**
Setiap paket disimpan hingga maksimal 25 versi. Anda dapat menghapus versi yang tidak diperlukan lagi.
**Topics**
+ [Menambahkan versi paket menggunakan konsol](#add-pkg-version)
+ [Menambahkan versi paket menggunakan AWS CLI](#add-pkg-version-cli)
## Menambahkan versi paket menggunakan konsol
Sebelum Anda melakukan langkah-langkah ini, ikuti petunjuk di [Buat paket di Distributor](distributor-working-with-packages-create.md) untuk membuat paket baru untuk versi tersebut. Kemudian, gunakan konsol Systems Manager untuk menambahkan versi paket baru keDistributor.
### Menambahkan versi paket menggunakan alur kerja Sederhana
Untuk menambahkan versi paket dengan menggunakan alur kerja **Sederhana**, siapkan file yang dapat diinstal yang telah diperbarui atau tambahkan file yang dapat diinstal untuk mendukung lebih banyak platform dan arsitektur. Kemudian, gunakan Distributor untuk mengunggah file yang dapat diinstal baru dan diperbarui dan tambahkan versi paket. Alur kerja **Tambah versi** yang disederhanakan di Distributor konsol memperbarui file manifes dan dokumen SSM terkait untuk Anda.
**Untuk menambahkan versi paket menggunakan alur kerja Sederhana**
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 tambahkan versi lain.
1. Pada halaman **Tambahkan versi**, pilih **Sederhana**.
1. Untuk **Nama versi**, masukkan nama versi. Nama versi untuk versi baru harus berbeda dengan nama versi lama. Nama versi dapat maksimal 512 karakter, dan tidak dapat berisi karakter khusus.
1. Untuk **Nama bucket S3**, pilih bucket S3 yang ada dari daftar. Ini bisa bucket yang sama yang Anda gunakan untuk menyimpan file yang dapat diinstal untuk versi yang lebih lama, tetapi nama file yang dapat diinstal harus berbeda untuk menghindari menimpa file yang dapat diinstal yang ada di dalam bucket.
1. Untuk **prefiks kunci S3**, masukkan subfolder bucket tempat aset yang dapat diinstal Anda disimpan.
1. Untuk **Unggah perangkat lunak**, arahkan ke file perangkat lunak yang dapat diinstal yang ingin Anda lampirkan ke versi baru. File yang dapat diinstal dari versi yang ada tidak secara otomatis disalin ke versi baru; Anda harus mengunggah file yang dapat diinstal dari versi paket yang lebih lama jika Anda ingin salah satu file yang dapat diinstal yang sama menjadi bagian dari versi baru. Anda dapat mengunggah lebih dari satu file perangkat lunak dalam satu tindakan.
1. Untuk **Platform target**, verifikasikan bahwa platform sistem operasi target yang ditampilkan untuk setiap file yang dapat diinstal benar. Jika sistem operasi yang ditampilkan tidak benar, pilih sistem operasi yang benar dari daftar dropdown.
Di alur kerja versioning **Sederhana**, karena Anda mengunggah setiap file yang dapat diinstal hanya sekali, langkah tambahan diperlukan untuk menargetkan satu file di beberapa sistem operasi. Misalnya, jika Anda mengunggah file perangkat lunak yang dapat diinstal bernama`Logtool_v1.1.1.rpm`, Anda harus mengubah beberapa default dalam alur kerja **Sederhana** untuk menginstruksikan Distributor agar menargetkan perangkat lunak yang sama di Amazon Linux dan sistem operasi. Ubuntu Server Anda dapat melakukan salah satu hal berikut untuk mengatasi keterbatasan ini.
+ Gunakan alur kerja versioning **Lanjutan** sebagai gantinya, zip setiap file yang dapat diinstal ke dalam file .zip sebelum Anda memulai, dan secara manual menulis manifes sehingga satu file yang dapat diinstal dapat ditargetkan pada beberapa platform atau versi sistem operasi . Untuk informasi selengkapnya, lihat [Menambahkan versi paket menggunakan alur kerja Lanjutan](#add-pkg-version-adv).
+ Edit file manifes secara manual di alur kerja **Sederhana** sehingga file .zip Anda ditargetkan pada beberapa versi atau platform sistem operasi. Untuk informasi selengkapnya tentang cara melakukan ini, lihat akhir langkah 4 di [Langkah 2: Buat manifes paket JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Untuk **versi Platform**, verifikasi bahwa versi platform sistem operasi yang ditampilkan adalah versi rilis utama yang diikuti oleh wildcard (8.\*), atau versi rilis sistem operasi yang tepat yang Anda inginkan untuk diterapkan oleh perangkat lunak Anda. **\_any** Untuk informasi selengkapnya tentang bagaimana cara menentukan versi platform, lihat langkah 4 di [Langkah 2: Buat manifes paket JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Untuk **Arsitektur**, pilih arsitektur prosesor yang benar untuk setiap file yang dapat diinstal dari daftar drop-down. Untuk informasi selengkapnya tentang arsitektur yang didukung, lihat [Platform dan arsitektur paket yang didukung](distributor.md#what-is-a-package-platforms).
1. (Opsional) Perluas **Skrip**, dan tinjau skrip instalasi dan penghapusan instalasi yang Distributor dihasilkan untuk perangkat lunak yang dapat diinstal.
1. Untuk menambahkan lebih banyak file perangkat lunak yang dapat diinstal ke versi baru, pilih **Tambahkan perangkat lunak**. Jika tidak, lanjutkan ke langkah berikutnya.
1. (Opsional) Perluas **Manifest**, dan tinjau manifes paket JSON yang Distributor menghasilkan perangkat lunak yang dapat diinstal. Jika Anda mengubah informasi tentang perangkat lunak yang dapat diinstal sejak Anda memulai prosedur ini, seperti versi platform atau platform target, pilih **Buat manifes** untuk menampilkan manifes paket yang diperbarui.
Anda dapat mengedit manifest secara manual jika Anda ingin menargetkan perangkat lunak yang dapat diinstal di lebih dari satu sistem operasi, seperti yang dijelaskan pada langkah 9. Untuk informasi selengkapnya tentang mengedit manifes, lihat [Langkah 2: Buat manifes paket JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Setelah selesai menambahkan perangkat lunak dan meninjau platform target, versi, dan data arsitektur, pilih **Tambahkan versi**.
1. Tunggu Distributor hingga selesai mengunggah perangkat lunak Anda dan membuat versi paket baru. Distributormenampilkan status unggahan untuk setiap file yang dapat diinstal. Tergantung pada jumlah dan ukuran paket yang Anda tambahkan, ini bisa memakan waktu beberapa menit. Distributorsecara otomatis mengarahkan Anda ke halaman **Package details** untuk paket, tetapi Anda dapat memilih untuk membuka halaman ini sendiri setelah perangkat lunak diunggah. Halaman **Package details** tidak menampilkan semua informasi tentang paket Anda sampai Distributor selesai membuat versi paket baru. Untuk menghentikan pengunggahan dan pembuatan versi paket, pilih **Hentikan pengunggahan**.
1. Jika tidak Distributor dapat mengunggah file yang dapat diinstal perangkat lunak apa pun, ini akan menampilkan pesan **gagal Unggah**. Untuk mencoba lagi pengunggahan, pilih **Coba unggah lagi**. Untuk informasi selengkapnya tentang cara memecahkan masalah kegagalan pembuatan versi paket, lihat [Pemecahan masalah AWS Systems ManagerDistributor](distributor-troubleshooting.md).
1. Setelah Distributor selesai membuat versi paket baru, pada halaman **Detail** paket, pada tab **Versi**, lihat versi baru dalam daftar versi paket yang tersedia. Tetapkan versi default paket dengan memilih versi, dan kemudian memilih **Tetapkan versi default**.
Jika Anda tidak menetapkan versi default, versi paket terbaru adalah versi default.
### Menambahkan versi paket menggunakan alur kerja Lanjutan
Untuk menambahkan versi paket, [buat paket](distributor-working-with-packages-create.md), lalu gunakan Distributor untuk menambahkan versi paket dengan menambahkan entri ke dokumen SSM yang ada untuk versi yang lebih lama. Untuk menghemat waktu, perbarui manifes untuk versi paket yang lebih lama, ubah nilai entri `version` dalam manifes (sebagai contoh, dari `Test_1.0` ke `Test_2.0`) dan simpan itu sebagai manifes untuk versi baru. Anda harus memiliki manifest yang diperbarui untuk menambahkan versi paket baru dengan menggunakan alur kerja **Lanjutan**.
**Untuk menambahkan versi paket menggunakan alur kerja Advanced**
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 tambahkan versi lain, lalu pilih **Tambahkan versi**.
1. Untuk **Nama versi**, masukkan nilai yang tepat yang ada di entri `version` file manifes Anda.
1. Untuk **Nama bucket S3**, pilih bucket S3 yang ada dari daftar. Ini bisa bucket yang sama yang Anda gunakan untuk menyimpan file yang dapat diinstal untuk versi yang lebih lama, tetapi nama file yang dapat diinstal harus berbeda untuk menghindari menimpa file yang dapat diinstal yang ada di dalam bucket.
1. Untuk **Prefiks kunci S3**, masukkan subfolder bucket tempat aset yang dapat diinstal Anda disimpan.
1. Untuk **Manifes**, pilih **Ekstrak dari paket** untuk menggunakan manifes yang Anda unggah ke bucket S3 dengan file .zip Anda.
(Opsional) Jika Anda tidak mengunggah manifest JSON yang telah direvisi ke bucket Amazon S3 tempat Anda menyimpan file .zip, pilih **Manifes baru**. Anda dapat menulis atau menempelkan seluruh manifes di kolom editor JSON. Untuk informasi selengkapnya tentang cara membuat manifes JSON, lihat [Langkah 2: Buat manifes paket JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Setelah Anda selesai dengan manifes, pilih **Tambah versi paket**.
1. Pada halaman **Detail** paket, pada tab **Versi**, lihat versi baru dalam daftar versi paket yang tersedia. Tetapkan versi default paket dengan memilih versi, dan kemudian memilih **Tetapkan versi default**.
Jika Anda tidak menetapkan versi default, versi paket terbaru adalah versi default.
## Menambahkan versi paket menggunakan AWS CLI
Anda dapat menggunakan AWS CLI untuk menambahkan versi paket baru keDistributor. Sebelum menjalankan perintah ini, Anda harus membuat versi paket baru dan mengunggahnya ke S3, seperti yang dijelaskan pada awal topik ini.
**Untuk menambahkan versi paket menggunakan AWS CLI**
1. Jalankan perintah berikut untuk mengedit AWS Systems Manager dokumen dengan entri untuk versi paket baru. Ganti {{document-name}} dengan nama dokumen Anda. Ganti {{amzn-s3-demo-bucket}} dengan URL manifes JSON yang Anda salin. [Langkah 3: Unggah paket dan manifes ke bucket Amazon S3](distributor-working-with-packages-create.md#packages-upload-s3) {{S3-bucket-URL-of-package}}adalah URL bucket Amazon S3 tempat seluruh paket disimpan. Ganti {{version-name-from-updated-manifest}} dengan nilai `version` dalam manifes. Tetapkan parameter `--document-version` ke `$LATEST` untuk membuat dokumen yang terkait dengan versi paket ini menjadi versi terbaru dokumen.
```
aws ssm update-document \
--name "{{document-name}}" \
--content "{{S3-bucket-URL-to-manifest-file}}" \
--attachments Key="SourceUrl",Values="{{amzn-s3-demo-bucket}}" \
--version-name {{version-name-from-updated-manifest}} \
--document-version $LATEST
```
Berikut adalah contoh.
```
aws ssm update-document \
--name ExamplePackage \
--content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
--attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
--version-name 1.1.1 \
--document-version $LATEST
```
1. Jalankan perintah berikut untuk memverifikasi bahwa paket Anda telah diperbarui dan menampilkan manifes paket. Ganti {{package-name}} dengan nama paket Anda, dan secara opsional, {{document-version}} dengan nomor versi dokumen (tidak sama dengan versi paket) yang Anda perbarui. Jika versi paket ini terkait dengan versi terbaru dokumen, Anda dapat menentukan `$LATEST` untuk nilai parameter `--document-version` opsional.
```
aws ssm get-document \
--name "{{package-name}}" \
--document-version "{{document-version}}"
```
Untuk informasi tentang opsi lain yang dapat Anda gunakan dengan **update-document** perintah, lihat [https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html)di AWS Systems Manager bagian *Referensi AWS CLI Perintah*.