Buat paket - AWS Systems Manager
Membuat sebuah paket (sederhana)Membuat paket (lanjutan)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat paket

Untuk membuat paket, siapkan perangkat lunak atau aset yang dapat diinstal Anda, satu file per platform sistem operasi. Setidaknya satu file diperlukan untuk membuat paket.

Platform yang berbeda terkadang menggunakan file yang sama, namun semua file yang Anda lampirkan ke paket harus tercantum dalam bagian Files manifes. Jika Anda membuat paket dengan menggunakan alur kerja sederhana di konsol, manifes akan dibuat untuk Anda. Jumlah maksimum file yang dapat Anda lampirkan ke dokumen tunggal adalah 20. Ukuran maksimum setiap file adalah 1 GB. Untuk informasi selengkapnya tentang platform yang didukung, lihat Platform dan arsitektur paket yang didukung.

Saat Anda membuat paket, sistem membuat SSMdokumen baru. Dokumen ini memungkinkan Anda untuk menyebarkan paket ke node terkelola.

Untuk tujuan demonstrasi saja, paket contoh, ExamplePackage.zip, tersedia untuk Anda unduh dari situs web kami. Paket contoh mencakup JSON manifes lengkap dan tiga file.zip yang berisi installer untuk PowerShell v7.0.0. Skrip instalasi dan penghapusan instalasi tidak berisi perintah yang valid. Meskipun Anda harus men-zip setiap perangkat lunak yang dapat diinstal dan skrip ke file .zip untuk membuat paket di alur kerja Lanjutan, Anda tidak men-zip aset yang dapat diinstal di alur kerja Sederhana.

Membuat sebuah paket (sederhana)

Bagian ini menjelaskan cara membuat paket Distributor dengan memilih alur kerja pembuatan paket sederhana di Distributor konsol. Distributoradalah kemampuan AWS Systems Manager. Untuk membuat paket, siapkan aset yang dapat diinstal Anda, satu file per platform sistem operasi. Setidaknya satu file diperlukan untuk membuat paket. Proses pembuatan paket Simple menghasilkan skrip instalasi dan penghapusan instalasi, hash file, dan manifes yang JSON diformat untuk Anda. Alur kerja Simple menangani proses mengunggah dan zip file yang dapat diinstal, dan membuat paket baru dan dokumen terkait. SSM Untuk informasi selengkapnya tentang platform yang didukung, lihat Platform dan arsitektur paket yang didukung.

Bila Anda menggunakan metode Simple untuk membuat paket, Distributor membuat install dan uninstall skrip untuk Anda. Namun, ketika Anda membuat paket untuk pembaruan di tempat, Anda harus menyediakan konten skrip update Anda sendiri pada tab Memperbarui skrip. Saat Anda menambahkan perintah input untuk update skrip, Distributor sertakan skrip ini dalam paket.zip yang dibuatnya untuk Anda, bersama dengan uninstall skrip install dan.

catatan

Gunakan opsi pembaruan In-place untuk menambahkan file baru atau yang diperbarui ke instalasi paket yang ada tanpa mengambil aplikasi terkait secara offline.

Untuk membuat paket (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 Buat paket, lalu pilih Sederhana.

  4. Pada halaman Buat paket, masukkan nama untuk paket Anda. Nama hanya dapat berisi huruf, angka, titik, tanda hubung, dan garis bawah. Nama harus cukup generik untuk diterapkan ke semua versi lampiran paket, tetapi cukup spesifik untuk mengidentifikasi tujuan paket.

  5. (Opsional) Untuk Nama versi, masukkan nama versi. Nama versi dapat maksimal 512 karakter, dan tidak dapat berisi karakter khusus.

  6. Untuk Lokasi, pilih bucket dengan menggunakan nama bucket dan awalan atau dengan menggunakan bucketURL.

  7. Untuk Unggah perangkat lunak, pilih Tambahkan perangkat lunak, lalu pergi ke file perangkat lunak yang dapat diinstal dengan ekstensi .rpm, .msi, atau .deb. Jika nama file berisi spasi, pengunggahan gagal. Anda dapat mengunggah lebih dari satu file perangkat lunak dalam satu tindakan.

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

    Untuk alur kerja pembuatan paket Sederhana, karena Anda mengunggah setiap file yang dapat diinstal hanya sekali, langkah-langkah tambahan diperlukan untuk menginstruksikan Distributor 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 di alur kerja Sederhana untuk menargetkan perangkat lunak yang sama di sistem operasi Amazon Linux dan Ubuntu. Saat menargetkan beberapa platform, lakukan salah satu hal berikut ini.

    • Gunakan alur kerja Lanjutan sebagai gantinya, zip setiap file yang dapat diinstal ke dalam file .zip sebelum Anda memulai, dan secara manual tulis manifest sehingga satu file yang dapat diinstal dapat ditargetkan pada beberapa versi atau platform sistem operasi. Untuk informasi selengkapnya, lihat Membuat paket (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 JSON paket.

  9. Untuk Versi platform, verifikasi bahwa versi platform sistem operasi yang ditampilkan adalah _any, versi rilis utama diikuti dengan wildcard (7.*), atau versi rilis sistem operasi yang tepat yang Anda ingin perangkat lunak Anda diterapkan padanya. Untuk informasi selengkapnya tentang menentukan versi platform sistem operasi, lihat langkah 4 di Langkah 2: Buat manifes JSON paket.

  10. Untuk Arsitektur, pilih arsitektur prosesor yang benar untuk setiap file yang dapat diinstal dari daftar dropdown. Untuk informasi selengkapnya tentang arsitektur prosesor yang didukung, lihat Platform dan arsitektur paket yang didukung.

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

  12. (Opsional) Guna menyediakan skrip pembaruan untuk digunakan dengan pembaruan di tempat, perluas Skrip, pilih tab Memperbarui skrip, dan masukkan perintah skrip pembaruan Anda.

    Systems Manager tidak membuat skrip pembaruan atas nama Anda.

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

  14. (Opsional) Perluas Manifest, dan tinjau manifes JSON paket yang Distributor dihasilkan untuk perangkat lunak yang dapat diinstal. Jika Anda mengubah informasi tentang perangkat lunak Anda sejak Anda memulai prosedur ini, seperti versi platform atau platform target, pilih Buat manifes untuk menampilkan manifes paket yang diperbarui.

    Anda dapat mengedit manifes secara manual jika Anda ingin menargetkan perangkat lunak yang dapat diinstal di lebih dari satu sistem operasi, seperti yang dijelaskan pada langkah 8. Untuk informasi selengkapnya tentang manifest, lihat Langkah 2: Buat manifes JSON paket.

  15. Pilih Buat paket.

Tunggu Distributor hingga selesai mengunggah perangkat lunak Anda dan membuat paket Anda. 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 baru, 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 proses pembuatan paket. Untuk menghentikan proses pengunggahan dan pembuatan paket, pilih Batalkan.

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 lagi pengunggahan. Untuk informasi selengkapnya tentang cara memecahkan masalah kegagalan pembuatan paket, lihat Pemecahan masalah AWS Systems ManagerDistributor.

Membuat paket (lanjutan)

Di bagian ini, pelajari cara pengguna tingkat lanjut dapat membuat paket Distributor setelah mengunggah aset yang dapat diinstal yang di-zip dengan skrip penginstalan dan penghapusan instalasi, serta file JSON manifes, ke bucket Amazon S3.

Untuk membuat paket, siapkan file .zip aset yang dapat diinstal Anda, satu file .zip per platform sistem operasi. Setidaknya satu file .zip diperlukan untuk membuat sebuah paket. Selanjutnya, buat JSON manifes. Manifes menyertakan penunjuk ke file kode paket Anda. Ketika Anda sudah menambahkan file kode yang diperlukan ke folder atau direktori, dan manifes diisi dengan nilai-nilai yang benar, unggah paket Anda ke bucket S3.

Contoh paket, ExamplePackage.zip, tersedia untuk Anda unduh dari situs web kami. Paket contoh mencakup JSON manifes lengkap dan tiga file.zip.

Langkah 1: Buat ZIP file

Dasar paket Anda setidaknya satu file .zip perangkat lunak atau aset yang dapat diinstal. Sebuah paket mencakup satu file .zip per sistem operasi yang ingin Anda dukung, kecuali satu file .zip dapat diinstal pada beberapa sistem operasi. Misalnya, Red Hat Enterprise Linux dan instans Amazon Linux biasanya dapat berjalan sama. RPMfile yang dapat dieksekusi, jadi Anda hanya perlu melampirkan satu file.zip ke paket Anda untuk mendukung kedua sistem operasi.

File yang diperlukan

Item berikut diperlukan dalam setiap file .zip:

  • Sebuah install dan uninstall naskah. Windows Servernode terkelola berbasis memerlukan PowerShell skrip (skrip bernama install.ps1 danuninstall.ps1). Node terkelola berbasis Linux memerlukan skrip shell (skrip bernama dan). install.sh uninstall.sh SSM Agentmenjalankan instruksi dalam install dan uninstall skrip.

    Misalnya, skrip instalasi Anda mungkin menjalankan penginstal (seperti .rpm atau .msi), mereka dapat menyalin file, atau mungkin mengatur konfigurasi.

  • File yang dapat dieksekusi, paket penginstal (.rpm, .deb, .msi, dll.), skrip lain, atau file konfigurasi.

File opsional

Item berikut adalah opsional dalam masing-masing file .zip:

  • Skrip update. Menyediakan skrip pembaruan memungkinkan Anda untuk menggunakan opsi In-place update untuk menginstal sebuah paket. Saat Anda ingin menambahkan file baru atau yang diperbarui ke instalasi paket yang ada, In-place update opsi tidak membuat aplikasi paket offline saat pembaruan dilakukan. Windows Servernode terkelola berbasis memerlukan PowerShell skrip (skrip bernamaupdate.ps1). Node terkelola berbasis Linux memerlukan skrip shell (skrip bernama). update.sh SSM Agentmenjalankan instruksi dalam update skrip.

Untuk informasi selengkapnya tentang menginstal atau memperbarui paket, lihat Menginstal atau memperbarui paket.

Untuk contoh file.zip, termasuk sampel install dan uninstall skrip, unduh paket contoh, ExamplePackage .zip.

Langkah 2: Buat manifes JSON paket

Setelah Anda menyiapkan dan zip file yang dapat diinstal, buat JSON manifes. Berikut ini adalah sebuah templat. Bagian-bagian templat manifes ini dijelaskan dalam prosedur di bagian ini. Anda dapat menggunakan JSON editor untuk membuat manifes ini dalam file terpisah. Atau, Anda dapat membuat manifes di AWS Systems Manager konsol saat membuat paket.

{
  "schemaVersion": "2.0",
  "version": "your-version",
  "publisher": "optional-publisher-name",
  "packages": {
    "platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-1.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-2.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-3.zip"
        }
      }
    }
  },
  "files": {
    ".zip-file-name-1.zip": {
      "checksums": {
        "sha256": "checksum"
      }
    },
    ".zip-file-name-2.zip": {
      "checksums": {
        "sha256": "checksum"
      }
    }
  }
}
Untuk membuat manifes JSON paket

  1. Tambahkan versi skema ke manifes Anda. Dalam rilis ini, versi skema selalu 2.0.

    { "schemaVersion": "2.0",

  2. Tambahkan versi paket yang ditetapkan pengguna ke manifes Anda. Ini juga merupakan nilai nama Versi yang Anda tentukan saat Anda menambahkan paket AndaDistributor. Ini menjadi bagian dari AWS Systems Manager dokumen yang Distributor dibuat ketika Anda menambahkan paket Anda. Anda juga memberikan nilai ini sebagai input dalam dokumen AWS-ConfigureAWSPackage untuk menginstal versi paket selain yang terbaru. Nilai version dapat berisi huruf, angka, garis bawah, tanda hubung, dan titik, dengan panjang maksimum 128 karakter. Kami sarankan Anda menggunakan versi paket yang dapat dibaca manusia agar lebih mudah bagi Anda dan administrator lain dalam menentukan versi paket yang tepat ketika Anda men-deploy. Berikut adalah contoh.

    "version": "1.0.1",

  3. (Opsional) Tambahkan nama penerbit. Berikut adalah contoh.

    "publisher": "MyOrganization",

  4. Tambahkan paket. Bagian "packages" menjelaskan platform, versi rilis, dan arsitektur yang didukung oleh file .zip dalam paket Anda. Untuk informasi selengkapnya, lihat Platform dan arsitektur paket yang didukung.

    Bagian platform-version bisa menjadi nilai wildcard,_any. Gunakan ini untuk menunjukkan bahwa file .zip mendukung setiap rilis platform. Anda juga dapat menentukan versi rilis utama diikuti dengan wildcard sehingga semua versi minor didukung, misalnya 7.*. Jika Anda memilih untuk menentukan platform-version nilai untuk versi sistem operasi tertentu, pastikan bahwa itu cocok dengan versi rilis persis dari sistem operasi AMI yang Anda targetkan. Berikut ini adalah sumber daya yang disarankan untuk mendapatkan nilai sistem operasi yang benar.

    • Pada node terkelola Windows Server berbasis, versi rilis tersedia sebagai data Windows Management Instrumentation (WMI). Anda dapat menjalankan perintah berikut dari prompt perintah untuk mendapatkan informasi versi, lalu mengurai hasilnya. version

      wmic OS get /format:list

    • Pada node terkelola berbasis Linux, dapatkan versi dengan memindai terlebih dahulu untuk rilis sistem operasi (perintah berikut). Cari nilai VERSION_ID.

      cat /etc/os-release

      Jika itu tidak mengembalikan hasil yang Anda butuhkan, jalankan perintah berikut untuk mendapatkan informasi LSB rilis dari /etc/lsb-release file, dan cari nilaiDISTRIB_RELEASE.

      lsb_release -a

      Jika metode ini gagal, Anda biasanya dapat menemukan rilis berdasarkan distribusi. Misalnya, padaDebian Server, Anda dapat memindai /etc/debian_version file, atau padaRed Hat Enterprise Linux, /etc/redhat-release file.

      hostnamectl
    "packages": {
    "platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-1.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-2.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-3.zip"
        }
      }
    }
  }

    Berikut adalah contohnya. Pada contoh ini, platform sistem operasi adalah amazon, versi rilis yang didukung adalah 2016.09, arsitekturnya adalah x86_64, dan file .zip yang mendukung platform ini adalah test.zip.

    {
    "amazon": {
        "2016.09": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

    Anda dapat menambahkan nilai wildcard _any untuk menunjukkan bahwa paket mendukung semua versi elemen induk. Misalnya, untuk menunjukkan bahwa paket didukung pada setiap versi rilis Amazon Linux, pernyataan paket Anda harus mirip dengan berikut ini. Anda dapat menggunakan wildcard _any di tingkat arsitektur atau versi untuk mendukung semua versi platform, atau semua arsitektur dalam versi, atau semua versi dan semua arsitektur platform.

    {
    "amazon": {
        "_any": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

    Contoh berikut menambahkan _any untuk menunjukkan bahwa paket pertama, data1.zip, didukung untuk semua arsitektur Amazon Linux 2016.09. Paket kedua,data2.zip, didukung untuk semua rilis Amazon Linux, tetapi hanya untuk node terkelola dengan x86_64 arsitektur. Baik versi 2016.09 dan _any adalah entri di bawah amazon. Ada satu platform (Amazon Linux), tetapi versi yang didukung, arsitektur, dan file .zip terkait berbeda.

    {
    "amazon": {
        "2016.09": {
            "_any": {
                "file": "data1.zip"
            }
        },
        "_any": {
            "x86_64": {
                "file": "data2.zip"
            }
        }
    }
}

    Anda dapat merujuk ke file .zip lebih dari sekali dalam bagian "packages" manifes, jika file.zip mendukung lebih dari satu platform. Misalnya, jika Anda memiliki file .zip mendukung Red Hat Enterprise Linux versi 7.x dan Amazon Linux, Anda memiliki dua entri di bagian "packages" yang mengarah ke file .zip yang sama, seperti yang ditunjukkan dalam contoh berikut.

    {
    "amazon": {
        "2018.03": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    },
    "redhat": {
        "7.*": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

  5. Tambahkan daftar file .zip yang merupakan bagian dari paket ini dari langkah 4. Setiap entri file memerlukan nama file dan checksum nilai hash sha256. Nilai checksum dalam manifes harus sesuai dengan nilai hash sha256 dalam aset yang di-zip untuk mencegah instalasi paket gagal.

    Untuk mendapatkan checksum yang tepat dari file yang dapat diinstal Anda, Anda dapat menjalankan perintah berikut. Di Linux, jalankan shasum -a 256 file-name.zip atau openssl dgst -sha256 file-name.zip. Di Windows, jalankan Get-FileHash -Path path-to-.zip-file cmdlet di. PowerShell

    Bagian "files" manifes termasuk satu referensi ke masing-masing file .zip dalam paket Anda.

    "files": {
        "test-agent-x86.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE2706223c7616ca9fb28863a233b38e5a23a8c326bb4ae241dcEXAMPLE"
            }
        },
        "test-agent-x86_64.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE572a745844618c491045f25ee6aae8a66307ea9bff0e9d1052EXAMPLE"
            }
        },
        "test-agent-x86_64.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel5-x86.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-x86.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE12a4abb10315aa6b8a7384cc9b5ca8ad8e9ced8ef1bf0e5478EXAMPLE"
            }
        },
        "test-agent-x86_64.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel5-x86.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-rhel5-x86_64.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE7ce8a2c471a23b5c90761a180fd157ec0469e12ed38a7094d1EXAMPLE"
            }
        }
    }

  6. Setelah Anda menambahkan informasi paket Anda, simpan dan tutup file manifes.

Berikut ini adalah contoh manifes yang telah selesai. Pada contoh ini, Anda memiliki file .zip, NewPackage_LINUX.zip, yang mendukung lebih dari satu platform, tetapi dirujuk dalam bagian "files" hanya sekali.

{
    "schemaVersion": "2.0",
    "version": "1.7.1",
    "publisher": "Amazon Web Services",
    "packages": {
        "windows": {
            "_any": {
                "x86_64": {
                    "file": "NewPackage_WINDOWS.zip"
                }
            }
        },
        "amazon": {
            "_any": {
                "x86_64": {
                    "file": "NewPackage_LINUX.zip"
                }
            }
        },
        "ubuntu": {
            "_any": {
                "x86_64": {
                    "file": "NewPackage_LINUX.zip"
                }
            }
        }
    },
    "files": {
        "NewPackage_WINDOWS.zip": {
            "checksums": {
                "sha256": "EXAMPLEc2c706013cf8c68163459678f7f6daa9489cd3f91d52799331EXAMPLE"
            }
        },
        "NewPackage_LINUX.zip": {
            "checksums": {
                "sha256": "EXAMPLE2b8b9ed71e86f39f5946e837df0d38aacdd38955b4b18ffa6fEXAMPLE"
            }
        }
    }
}

Contoh paket

Contoh paket, ExamplePackage.zip, tersedia untuk Anda unduh dari situs web kami. Paket contoh mencakup JSON manifes lengkap dan tiga file.zip.

Langkah 3: Unggah paket dan manifes ke bucket Amazon S3

Siapkan paket Anda dengan menyalin atau memindahkan semua file .zip ke dalam folder atau direktori. Sebuah paket yang valid memerlukan manifes yang Anda buat di Langkah 2: Buat manifes JSON paket dan semua file .zip yang diidentifikasi dalam daftar file manifes.

Untuk mengunggah paket dan manifes ke Amazon S3

  1. Salin atau pindahkan semua file arsip .zip yang Anda tentukan dalam manifes ke folder atau direktori. Jangan men-zip folder atau direktori tempat Anda memindahkan file arsip .zip dan file manifes Anda.

  2. Buat bucket atau pilih bucket yang ada. Untuk informasi selengkapnya, lihat Membuat Bucket di Panduan Memulai Amazon Simple Storage Service. Untuk informasi selengkapnya tentang cara menjalankan AWS CLI perintah untuk membuat bucket, lihat mbdi AWS CLI Command Reference.

  3. Unggah folder atau direktori ke bucket. Untuk instruksi, kunjungi Menambah Objek ke Bucket dalam Panduan Memulai Amazon Simple Storage Service. Jika Anda berencana untuk menempelkan JSON manifes Anda ke AWS Systems Manager konsol, jangan unggah manifes. Untuk informasi selengkapnya tentang cara menjalankan AWS CLI perintah untuk mengunggah file ke bucket, lihat mvdi AWS CLI Command Reference.

  4. Di halaman utama bucket, pilih folder atau direktori yang Anda unggah. Jika Anda mengunggah file Anda ke subfolder dalam bucket, pastikan untuk mencatat subfolder (juga dikenal sebagai prefiks). Anda memerlukan awalan untuk menambahkan paket Anda. Distributor

Langkah 4: Tambahkan paket ke Distributor

Anda dapat menggunakan AWS Systems Manager konsol, alat baris AWS perintah (AWS CLI dan AWS Tools for PowerShell), atau AWS SDKs untuk menambahkan paket baru keDistributor. Saat Anda menambahkan paket, Anda menambahkan SSMdokumen baru. Dokumen ini memungkinkan Anda untuk menyebarkan paket ke node terkelola.

Menambahkan paket (konsol)

Anda dapat menggunakan AWS Systems Manager konsol untuk membuat paket. Siapkan nama bucket tempat Anda mengunggah paket Anda di Langkah 3: Unggah paket dan manifes ke bucket Amazon S3.

Untuk menambahkan paket ke Distributor (konsol)

  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 Buat paket, lalu pilih Advanced.

  4. Pada halaman Buat paket, masukkan nama untuk paket Anda. Nama hanya dapat berisi huruf, angka, titik, tanda hubung, dan garis bawah. Nama harus cukup generik untuk diterapkan ke semua versi lampiran paket, tetapi cukup spesifik untuk mengidentifikasi tujuan paket.

  5. Untuk Nama versi, masukkan nilai yang tepat dari entri version dalam file manifes Anda.

  6. Untuk Nama bucket S3, pilih nama bucket tempat Anda mengunggah file .zip dan manifes dalam Langkah 3: Unggah paket dan manifes ke bucket Amazon S3.

  7. Untuk prefiks kunci S3, masukkan subfolder bucket tempat file .zip dan manifes disimpan.

  8. Untuk Manifes, pilih Ekstrak dari paket untuk menggunakan manifes yang telah Anda unggah ke bucket Amazon S3 dengan file .zip Anda.

    (Opsional) Jika Anda tidak mengunggah JSON manifes ke bucket S3 tempat Anda menyimpan file.zip, pilih Manifes baru. Anda dapat membuat atau menempelkan seluruh manifes di bidang JSON editor. Untuk informasi selengkapnya tentang cara membuat JSON manifes, lihatLangkah 2: Buat manifes JSON paket.

  9. Setelah Anda selesai dengan manifes, pilih Buat paket.

  10. Tunggu Distributor untuk membuat paket Anda dari file.zip dan manifes Anda. 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 baru, 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 proses pembuatan paket. Untuk menghentikan proses pengunggahan dan pembuatan paket, pilih Batalkan.

Menambahkan paket (AWS CLI)

Anda dapat menggunakan AWS CLI untuk membuat paket. URLSiapkan dari ember tempat Anda mengunggah paket Anda. Langkah 3: Unggah paket dan manifes ke bucket Amazon S3

Untuk menambahkan paket ke Amazon S3 (AWS CLI)

  1. Untuk menggunakan AWS CLI untuk membuat paket, jalankan perintah berikut, ganti package-name dengan nama paket Anda dan path-to-manifest-file dengan jalur file untuk file JSON manifes Anda. amzn-s3-demo-bucket adalah bucket URL Amazon S3 tempat seluruh paket disimpan. Ketika Anda menjalankan create-document perintah diDistributor, Anda menentukan Package nilai untuk--document-type.

    Jika Anda tidak menambahkan file manifes ke bucket Amazon S3, nilai --content parameter adalah jalur file ke file JSON manifes.

    aws ssm create-document \
    --name "package-name" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-value-from-manifest \
    --document-type Package

    Berikut adalah contohnya.

    aws ssm create-document \
    --name "ExamplePackage" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.0.1 \
    --document-type Package

  2. Verifikasi bahwa paket Anda telah ditambahkan dan tampilkan manifes paket dengan menjalankan perintah berikut, menggantikan package-name dengan nama paket Anda. Untuk mendapatkan versi tertentu dari dokumen (tidak sama dengan versi paket), Anda dapat menambahkan parameter --document-version.

    aws ssm get-document \
    --name "package-name"

Untuk informasi tentang pilihan lain yang dapat Anda gunakan dengan perintah create-document, lihat create-document di bagian AWS Systems Manager Referensi Perintah AWS CLI . Untuk informasi tentang pilihan lain yang dapat Anda gunakan dengan perintah get-document, lihat get-document.