Buat paket di Distributor

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

Di panel navigasi, pilih Distributor.

Pada Distributor beranda, pilih Buat paket, lalu pilih Sederhana.

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.

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

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

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.

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

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.

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.

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

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

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

(Opsional) Perluas Manifest, dan tinjau manifes JSON paket itu Distributor menghasilkan untuk perangkat lunak yang dapat diinstal Anda. 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.

Pilih Buat paket.

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

{ "schemaVersion": "2.0",

Tambahkan versi paket yang ditetapkan pengguna ke manifes Anda. Ini juga merupakan nilai nama Versi yang Anda tentukan saat Anda menambahkan paket Distributor. Ini menjadi bagian dari AWS Systems Manager dokumen yang Distributor membuat saat 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",

(Opsional) Tambahkan nama penerbit. Berikut adalah contoh.

"publisher": "MyOrganization",

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 yang tepat dari sistem operasi AMI yang Anda targetkan. Berikut ini adalah sumber daya yang disarankan untuk mendapatkan nilai sistem operasi yang benar.

"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 yang mendukung keduanya Red Hat Enterprise Linux Versi 7.x dan Amazon Linux, Anda memiliki dua entri di "packages" bagian yang mengarah ke file.zip yang sama, seperti yang ditunjukkan pada contoh berikut.

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

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"
            }
        }
    }

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

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.

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.

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.

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.

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

Di panel navigasi, pilih Distributor.

Pada Distributor beranda, pilih Buat paket, lalu pilih Advanced.

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.

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

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.

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

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.

Setelah Anda selesai dengan manifes, pilih Buat paket.

Tunggu Distributor untuk membuat paket Anda dari file.zip dan manifes Anda. Bergantung pada jumlah dan ukuran paket yang Anda tambahkan, ini bisa memakan waktu beberapa menit. Distributor Secara 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 menyelesaikan proses pembuatan paket. Untuk menghentikan proses pengunggahan dan pembuatan paket, pilih Batalkan.

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 di Distributor, 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

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"