Tambahkan versi ke Distributor paket - AWS Systems Manager
Menambahkan versi paket menggunakan konsolMenambahkan versi paket menggunakan AWS CLI

AWS Systems ManagerChange Managertidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat perubahan AWS Systems ManagerChange Manager ketersediaan.

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

Menambahkan versi paket menggunakan konsol

Sebelum Anda melakukan langkah-langkah ini, ikuti petunjuk di Buat paket di Distributor 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/.

  2. Di panel navigasi, pilih Distributor.

  3. Di Distributor halaman beranda, pilih paket yang ingin Anda tambahkan versi lain.

  4. Pada halaman Tambahkan versi, pilih Sederhana.

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

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

  7. Untuk prefiks kunci S3, masukkan subfolder bucket tempat aset yang dapat diinstal Anda disimpan.

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

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

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

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

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

  12. (Opsional) Perluas Skrip, dan tinjau skrip instalasi dan penghapusan instalasi yang Distributor dihasilkan untuk perangkat lunak yang dapat diinstal.

  13. Untuk menambahkan lebih banyak file perangkat lunak yang dapat diinstal ke versi baru, pilih Tambahkan perangkat lunak. Jika tidak, lanjutkan ke langkah berikutnya.

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

  15. Setelah selesai menambahkan perangkat lunak dan meninjau platform target, versi, dan data arsitektur, pilih Tambahkan versi.

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

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

  18. 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, 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/.

  2. Di panel navigasi, pilih Distributor.

  3. Di Distributor halaman beranda, pilih paket yang ingin Anda tambahkan versi lain, lalu pilih Tambahkan versi.

  4. Untuk Nama versi, masukkan nilai yang tepat yang ada di entri version file manifes Anda.

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

  6. Untuk Prefiks kunci S3, masukkan subfolder bucket tempat aset yang dapat diinstal Anda disimpan.

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

  8. Setelah Anda selesai dengan manifes, pilih Tambah versi paket.

  9. 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 S3-bucket-URL-of-packageadalah 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

  2. 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 update-documentdi AWS Systems Manager bagian Referensi AWS CLI Perintah.