View a markdown version of this page

Bekerja dengan produk komponen EC2 Image Builder - AWS Marketplace
Membangun dan menguji komponen Image BuilderMenyalin komponen ARNMembuat AWS Marketplace Kebijakan IAMMenciptakan AWS Marketplace IAM RoleSiapkan daftar komponen Image Builder AndaMenerbitkan daftar produk komponen Image BuilderMemperbarui informasi produk komponen Image BuilderMenambahkan versi baru ke produk komponen Image Builder yang adaMemperbarui informasi tentang versi yang adaMembatasi versi produk komponen Image BuilderMemantau set perubahanMengamankan unduhan perangkat lunak

Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API AWS Marketplace.

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

Bekerja dengan produk komponen EC2 Image Builder

Sebagai penjual AWS Marketplace, Anda dapat membuat daftar AMI-based produk yang dikirimkan ke pembeli AWS Marketplace menggunakan komponen EC2 Image Builder. Untuk membuat komponen Anda dan menerbitkan AWS Marketplace daftar, lanjutkan secara berurutan melalui bagian berikut.

Membangun dan menguji komponen Image Builder

Bangun dan uji komponen Anda di Image Builder. Untuk petunjuk, lihat Mengem bangkan komponen khusus untuk gambar Pembuat Gambar Anda di Panduan Pengguna Pembuat Gambar. Saat membuat komponen menggunakan Image Builder, pastikan Anda melakukan hal berikut:

  • Komponen dan semua dependensi yang mendasarinya, seperti bucket, rahasia, atau parameter Amazon Simple Storage Service (Amazon S3), harus dibuat di Wilayah AWS AS Timur (Virginia Utaraus-east-1) ().

  • Sertakan arsitektur yang didukung dan dependensi perangkat lunak apa pun dalam deskripsi komponen.

  • Uji komponen Anda di AWS akun Anda dengan membuat pipeline gambar dan menerapkan AMI yang dibuat oleh pipeline.

  • Jika komponen Anda berisi instruksi untuk menyalin binari, paket, atau file dari bucket S3, gunakan modul S3Download tindakan. Dalam S3Download modul, forsource, masukkan lokasi statis file Anda di bucket S3. Contoh berikut menyalin biner dari bucket S3 sebagai bagian dari instalasi komponen.

    - name: DownloadMyFile
    action: S3Download
    inputs:
      - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip
        destination: C:\myfolder\package.zip

  • Komponen dapat menelan file hingga 2 GB saat menggunakan S3Download tindakan.

  • Jika komponen Anda menggunakan parameter, pastikan semua parameter memiliki nilai default. Misalnya, jika Anda memiliki parameter bernamaregion, pastikan bahwa Anda memiliki nilai default yang valid sepertius-east-1. Nilai default ini untuk AWS Marketplace pemrosesan dan pengujian. Pengujian mungkin gagal jika Anda tidak menyertakan nilai default.

  • Jika komponen Anda menggunakan AWS Secrets Manager, Penyimpanan Parameter, atau kemampuan AWS Systems Manager untuk menyimpan parameter, lakukan hal berikut:

    • Untuk mengambil nilai sebagai langkah dalam komponen Anda, sematkan AWS Command Line Interface perintah di file konfigurasi YAML Anda.

    • Buat entri yang sesuai di Secrets Manager atau Parameter Store di AWS akun Anda. Gunakan kunci default dan berikan nilai yang valid yang akan membantu dalam membangun komponen selama proses AWS Marketplace pengujian. Misalnya, katakanlah Anda memiliki parameter yang di saas_token panggil dengan nilai default token yang menggunakan Parameter Store. Dalam hal ini, buat pasangan kunci-nilai di Parameter Store. Gunakan token sebagai kunci. Untuk nilainya, masukkan token SaaS yang valid untuk aplikasi Anda.

      Perhatikan bahwa nilai yang disimpan di akun AWS Marketplace penjual Anda hanya akan digunakan untuk tujuan AWS Marketplace pengujian. Nilai-nilai ini tidak akan dibagikan dengan pembeli.

    • AWS Marketplace secara otomatis menghasilkan Amazon Machine Images (AMI) untuk komponen Anda di semua versi sistem operasi kompatibel yang Anda pilih selama proses pembuatan komponen. Saat membangun komponen Anda, pilih setidaknya satu versi sistem operasi yang kompatibel. Validasi kompatibilitas komponen Anda dengan semua versi sistem operasi yang dipilih dengan menggunakan pipeline EC2 Image Builder untuk membuat dan menguji AMI.

Menyalin komponen ARN

Setelah membuat dan menguji komponen pada Image Builder, salin dan simpan komponen ARN. Anda akan menggunakan ARN saat Anda mempublikasikan daftar produk menggunakan API AWS Marketplace Katalog.

Untuk menyalin komponen Image Builder ARN

  1. Masuk ke AWS Management Console dan buka konsol Image Builder dihttps://console.aws.amazon.com/imagebuilder/.

  2. Di bilah navigasi kiri, di bawah Sumber daya tersimpan, pilih Komponen.

  3. Pada halaman Komponen, untuk Pemilik Filter, pilih Dim iliki oleh saya.

  4. Pilih nama komponen.

  5. Pada halaman detail komponen, di bagian Ring kasan, salin ARN.

Membuat AWS Marketplace Kebijakan IAM

Buat kebijakan IAM berikut untuk memberikan AWS Marketplace akses ke komponen Image Builder Anda dan sumber daya terkait seperti bucket dan rahasia Amazon S3. Gunakan contoh kebijakan yang disediakan. Anda melampirkan kebijakan ini ke peran AWS Marketplace IAM. Untuk bantuan membuat kebijakan, lihat Membuat kebijakan menggunakan editor JSON di Panduan Pengguna IAM.

  • Kebijakan Image Builder mendapatkan komponen, AWS Marketplace untuk memungkinkan akses komponen Anda di Image Builder. Kebijakan ini diperlukan. Sebutkan kebijakan mp_ib_ingest.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "imagebuilder:GetComponent",
            "Resource": "*"
        }
    ]
}

  • Kebijakan akses baca Amazon S3, AWS Marketplace untuk memungkinkan pengambilan biner dari bucket S3. Kebijakan ini hanya diperlukan jika komponen Anda menggunakan modul S3Download tindakan dan menyimpan binari terkait dalam bucket S3. Sebutkan kebijakan mp_ib_s3_read_only.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "ListObjectsInBucket",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket_name"
            ]
        },
        {
            "Sid": "ReadObjectsInBucket",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:GetObjectAttributes"
            ],
            "Resource": [
                "arn:aws:s3:::bucket_name/*"
            ]
        }
    ]
}

  • Kebijakan akses baca Secrets Manager, untuk memungkinkan AWS Marketplace untuk mengambil rahasia yang disimpan di Manajer Rahasia. Kebijakan ini hanya diperlukan jika komponen Anda menggunakan Manajer Rahasia untuk menyimpan rahasia. Sebutkan kebijakan mp_ib_sm_read_only. Untuk membatasi kebijakan hanya untuk rahasia Anda, ganti bagian * di Resource bagian dengan rahasia Anda.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

  • Kebijakan akses baca Penyimpanan Parameter, untuk memungkinkan AWS Marketplace untuk mengambil rahasia yang disimpan di Penyimpanan Parameter. Kebijakan ini hanya diperlukan jika komponen Anda menggunakan Penyimpanan Parameter untuk menyimpan rahasia. Sebutkan kebijakan mp_ib_ssm_parameter_read_only. Untuk membatasi kebijakan hanya untuk rahasia Anda, ganti bagian * di Resource bagian dengan rahasia Anda.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "Statement1",
            "Effect": "Allow",
            "Action": [
                "ssm:getParameter"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Menciptakan AWS Marketplace IAM Role

Gunakan prosedur berikut untuk membuat peran AWS Marketplace IAM dengan kebijakan untuk memberikan AWS Marketplace akses ke komponen Anda dan dependensinya.

Untuk membuat AWS Marketplace IAM Role

  1. Masuk ke Konsol AWS Manajemen dan buka konsol IAM di https://console.aws.amazon.com/iam/.

  2. Di bilah navigasi kiri, pilih Per an.

  3. Pilih Buat peran.

  4. Pilih Kebijakan kepercayaan khusus.

  5. Masukkan pernyataan berikut:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "Statement1",
            "Effect": "Allow",
            "Principal": {
                "Service": "assets.marketplace.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

  6. Pilih Berikutnya.

  7. Tambahkan kebijakan Image Builder get-component yang Anda buat sebelumnya. Kebijakan get-component diperlukan. Tambahkan kebijakan yang relevan untuk S3, Secrets Manager, dan Parameter Store jika komponen Anda menggunakan AWS layanan ini.

  8. Pilih Berikutnya.

  9. Masukkan nama peran, sepertiMPEC2IBIngestion.

  10. Pilih Buat peran.

Salin AWS Marketplace ARN peran IAM

Setelah membuat peran AWS Marketplace IAM, salin dan simpan peran ARN. Anda akan menggunakan ARN saat menerbitkan daftar menggunakan API AWS Marketplace Katalog.

Untuk menyalin AWS Marketplace ARN peran IAM

  1. Di konsol IAM, di bilah navigasi kiri, pilih Peran.

  2. Pilih peran AWS Marketplace IAM yang Anda buat sebelumnya, sepertiMPEC2IBIngestion.

  3. Pada halaman detail peran, di bagian Ring kasan, salin ARN.

Siapkan daftar komponen Image Builder Anda

Sebelum mem AWS Marketplace publikasikan iklan Anda, pastikan Anda memiliki informasi berikut:

  • Metadata produk — Metadata mencakup logo produk, judul produk, perjanjian Lisensi Pengguna Akhir, jenis instans yang didukung, dan Wilayah AWS.

  • Informasi harga — Anda dapat menawarkan produk Anda secara gratis, dengan tarif per jam, atau dengan tarif per jam dengan periode uji coba gratis awal. Bawa lisensi Anda sendiri (BYOL) tidak didukung.

  • Detail komponen — Detail mencakup komponen Amazon Resource Number (ARN), detail penggunaan, dan peran AWS Identity and Access Management (IAM) yang AWS Marketplace akan diasumsikan untuk memproses komponen Anda.

Menerbitkan daftar produk komponen Image Builder

Topik ini berisi petunjuk untuk menerbitkan daftar komponen EC2 Image Builder Anda tentang AWS Marketplace penggunaan API AWS Marketplace Katalog.

Prasyarat

Pastikan Anda memiliki hal-hal berikut sebelum menerbitkan daftar produk komponen Image Builder Anda:

  • Pendaftaran sebagai penjual di AWS Marketplace. Untuk informasi selengkapnya, lihat Daftar sebagai penjual AWS Marketplace.

  • Pengguna IAM dengan AWSMarketplaceSellerFullAccess izin.

  • Bucket Amazon Simple Storage Service (Amazon S3) yang dapat diakses publik untuk meng-host logo perusahaan dan EULA Anda, jika digunakan dalam komponen Anda. Anda akan memasukkan URL untuk bucket S3 di file ChangeSet JSON Anda.

  • AWS Command Line Interface (AWS CLI). Untuk informasi selengkapnya, lihat Apa itu Antarmuka Baris Perintah AWS? dalam Panduan AWS Command Line Interface Pengguna.

Membuat produk komponen Image Builder pada AWS Marketplace

Untuk membuat produk komponen EC2 Image Builder AWS Marketplace menggunakan API Katalog, lihat. Buat produk

Memperbarui informasi produk komponen Image Builder

Anda dapat memperbarui informasi tentang produk komponen Image Builder di Portal AWS Marketplace Manajemen.

Untuk memperbarui informasi produk komponen Image Builder

  1. Buka Portal Manajemen AWS Marketplace dan masuk ke akun penjual Anda.

  2. Pada menu Produk, pilih Server.

  3. Pada halaman produk Server, pilih produk.

  4. Pada halaman detail produk, pada menu Minta perubahan, pilih item yang sesuai dengan informasi yang ingin Anda perbarui.

  5. Setelah mengirimkan perubahan apa pun, permintaan akan muncul di tab Per mintaan dalam status “Sedang ditinjau”, dan akan berubah menjadi “Berhasil” setelah selesai.

Menambahkan versi baru ke produk komponen Image Builder yang ada

Anda dapat menambahkan versi baru ke produk komponen Pembuat Gambar AWS Marketplace dengan menggunakan AWS Marketplace Catalog API.

Untuk menambahkan versi baru

  1. Dari Portal Manajemen AWS Marketplace, dapatkan ID Produk.

    1. Buka Portal Manajemen AWS Marketplace dan masuk ke akun penjual Anda.

    2. Pada menu Produk, pilih Server.

    3. Pada halaman produk Server, pilih produk.

    4. Dalam Ringkasan Produk, salin ID Produk.

  2. Menggunakan contoh kode berikut, buat file changeset dalam format JSON. Dalam contoh, ganti your-product-ID dengan ID produk yang Anda peroleh pada langkah 1. Ganti new-version-name dengan judul versi Anda. Ganti new-delivery-option-title dengan judul opsi pengiriman Anda.

    [
    {
        "ChangeType": "AddDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "Version": {
                "VersionTitle": "new-version-name",
                "ReleaseNotes": "Release notes goes here."
            },
            "DeliveryOptions": [
                {
                    "DeliveryOptionTitle": "new title",
                    "Details": {
                        "Ec2ImageBuilderComponentDeliveryOptionDetails": {
                            "UsageInstructions": "Test usage instructions for IB",
                            "AccessRoleArn": "arn:aws:iam::123456789:role/sample",
                            "ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1"
                        }
                    }
                }
            ]
        }
    }
]

  3. Simpan file changeset dengan namaaddIBversion.json.

  4. Di terminal Anda atau AWS CloudShell, jalankan perintah berikut:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json

Per start-change-set intah akan mengembalikan ChangeSetId nilai. Untuk memantau set perubahan, lihatMemantau set perubahan.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddDeliveryOptions tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

catatan

Kode kesalahan berikut khusus untuk metode pengiriman Image Builder. Untuk pesan kesalahan yang ada di bidang sepertiUsage Instructions,Recommended Instance type, danAccessRoleArn, lihatTambahkan versi baru.

Kode kesalahan Pesan kesalahan

ASET_TIDAK_DITEMUKAN

Periksa apakah [component arn] ada di AWS akun [account-id] dan accessARN yang disediakan [ARN] memiliki izin untuk berbagi komponen Pembuat Gambar ini dengan. AWS Marketplace

ASET_TIDAK_DITEMUKAN

Tautan S3 yang ditentukan [x] dalam komponen [x] tidak ada. Berikan tautan S3 yang valid di dalam komponen.

NAMA_KOMPONEN DUPLIKAT

Nama komponen [x] sudah ada dalam versi yang sama. Berikan nama komponen yang berbeda.

NAMA_KOMPONEN DUPLIKAT

Nama komponen [x] yang Anda berikan sudah digunakan oleh produk yang berbeda. Berikan nama komponen yang berbeda.

DUPLIKAT_KOMPONEN_ARN

Komponen Arn [x] harus berbeda dari Komponen Arn yang digunakan dalam opsi pengiriman lain dari versi yang sama dari produk ini.

DUPLIKAT_KOMPONEN_ARN

Komponen ARN [x] harus berbeda dari komponen ARN yang digunakan dalam versi lain dari produk ini.

SCANNING_ERROR

Perbaiki kerentanan keamanan [y] pada Komponen [x].

PENGECUALIAN AKSES_ASET

Kami tidak memiliki izin yang diperlukan untuk membaca konten dari bucket S3 yang ditentukan [x]. Pastikan bucket S3 memiliki izin baca yang sesuai.

PENGECUALIAN AKSES_ASET

Kami tidak memiliki izin yang diperlukan untuk membaca konten komponen tertentu ARN [x]. Pastikan komponen ARN memiliki izin baca yang sesuai.

PENGECUALIAN AKSES_ASET

Kami tidak memiliki izin yang diperlukan untuk membaca isi dari URI paket yang ditentukan [x]. Pastikan URI paket memiliki izin baca yang sesuai.

PENGECUALIAN AKSES_ASET

Gagal membaca dari sumber HTTP [x]. Verifikasi bahwa sumber HTTP yang disediakan benar.

PAKET_KOMPONEN_IMAGE_BUILDER_TIDAK VALID

Aset komponen melebihi batas ukuran untuk konsumsi. Kurangi ukuran un S3/web duhan atau hilangkan unduhan yang tidak perlu untuk melanjutkan.

PAKET_KOMPONEN_IMAGE_BUILDER_TIDAK VALID

Aset komponen membutuhkan waktu terlalu lama untuk dicerna. Pastikan koneksi jaringan Anda stabil dan memiliki bandwidth yang memadai.

TERLALU BANYAK_IMAGE_BUILDER_COMPONENTS

Maksimal 5 nama komponen unik didukung per produk, batasi opsi pengiriman tambahan.

TIDAK LENGKAP_SELER_PROFIL_PUBLIK

Profil publik penjual Anda tidak lengkap. Lengkapi profil publik Anda sebelum menambahkan versi ke produk.

DESKRIPSI_TIDAK VALID

Deskripsi tidak ada. Berikan deskripsi dengan kurang dari 1024 karakter dalam komponen [x].

NAMA_KOMPONEN TIDAK VALID

Berikan nama komponen dengan kurang dari [x] karakter.

VERSI_OS_YANG TIDAK VALID YANG DIDUKUNG

Versi OS tidak ada. Berikan versi OS yang didukung yang valid di komponen [x].

FORMAT_JALUR TIDAK VALID

Langkah [STEP_NAME] dalam fase [PHASE_NAME] tidak diizinkan untuk menggunakan S3 atau URL web untuk tindakan tersebut. InstallMSI/UninstallMSI Pastikan bahwa jalur yang ditentukan adalah jalur lokal yang valid yang dapat diakses dari sistem yang menjalankan tindakan.

TIPE_OS YANG TIDAK KOMPATIBEL

Komponen yang ditentukan tipe OS [x] tidak kompatibel dengan platform gambar dasar. Menyediakan jenis OS yang kompatibel dengan gambar dasar.

PENGECUALIAN AKSES_ASET

Kami tidak memiliki izin yang diperlukan untuk membaca konten dari parameter SSM yang ditentukan [x]. Pastikan peran akses IAM yang disediakan dalam input API memiliki izin baca yang diperlukan.

PENGECUALIAN AKSES_ASET

Kami tidak memiliki izin yang diperlukan untuk membaca konten dari SecretsManager rahasia yang ditentukan [x]. Pastikan peran akses IAM yang disediakan dalam input API memiliki izin baca yang diperlukan.

VERSI_IB_COMPONENT_BUILD_TIDAK VALID

Komponen ARN [x] memiliki versi build [y]. AWS Marketplace hanya mendukung versi build 1. Buat versi EC2 Image Builder baru dengan Build versi 1, dan coba lagi AWS Marketplace

PARAMETER_KOMPONEN IB_TIDAK VALID

Tidak dapat mengurai parameter SSM di input [x] untuk komponen [y].

PARAMETER_KOMPONEN IB_TIDAK VALID

Tidak dapat mengurai SecretsManager rahasia dalam input [x] untuk komponen [y].

HILANGAN_IB_COMPONENT_PARAMETER

Parameter tidak ditemukan di komponen [x] untuk input [y]

PARAMETER_KOMPONEN IB_TIDAK VALID

Berikan nilai default untuk parameter [x] di komponen [y].

UJI_PELUNCURAN GAGAL

Uji peluncuran untuk komponen [x] gagal. Pesan galat: [z]

SSHAuthFailedForUserAndKeypair

Tidak dapat masuk ke instance dengan nama pengguna default OS [X].

INVALID_IB_COMPONENT

Diperlukan fase pembuatan komponen. Tambahkan fase build yang valid ke komponen [x]

DUPLIKAT_VERSI_JUDUL

Judul versi harus berbeda dari judul versi lain dari produk ini.

JUDUL_VERSI_TIDAK VALID

Hapus spasi sebelum simbol merek dagang.

JUDUL_VERSI_TIDAK VALID

Hapus karakter yang tidak didukung: [x, y, z]

JUDUL_VERSI_TIDAK VALID

Hapus spasi dari awal judul versi.

JUDUL_VERSI_TIDAK VALID

Berikan judul versi dengan kurang dari [x] karakter.

CATATAN_RILIS YANG TIDAK VALID

Hapus spasi sebelum simbol merek dagang.

CATATAN_RILIS YANG TIDAK VALID

Hapus karakter yang tidak didukung: [x, y, z]

CATATAN_RILIS YANG TIDAK VALID

Hapus spasi dari awal catatan rilis.

CATATAN_RILIS YANG TIDAK VALID

Berikan catatan rilis dengan kurang dari (x) karakter.

INSTRUKSI_PENGGUNAAN_TIDAK VALID

Hapus spasi sebelum simbol merek dagang.

INSTRUKSI_PENGGUNAAN_TIDAK VALID

Hapus karakter yang tidak didukung: [x, y, z]

INSTRUKSI_PENGGUNAAN_TIDAK VALID

Berikan instruksi penggunaan dengan kurang dari (x) karakter.

DUPLIKAT_PENGIRIMAN_OPSI_JUDUL

Berikan judul opsi pengiriman yang unik.

JUDUL OPSI PENGIRIMAN YANG TIDAK VALID

Judul opsi pengiriman sudah ada, coba lagi dengan judul yang berbeda.

Memperbarui informasi tentang versi yang ada

Untuk memperbarui informasi tentang versi yang sudah ada

  1. Dari Portal Manajemen AWS Marketplace, dapatkan ID Produk.

    1. Buka Portal Manajemen AWS Marketplace dan masuk ke akun penjual Anda.

    2. Pada menu Produk, pilih Server.

    3. Pada halaman produk Server, pilih produk.

    4. Dalam Ringkasan Produk, salin ID Produk.

  2. Di terminal Anda, jalankan perintah berikut. Dalam perintah, ganti your-product-ID dengan ID yang Anda peroleh pada langkah 1.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

  3. Dalam output yang dikembalikan, buka Versions bagianDetailsDocument,. Salin Id nilaiDeliveryOptions, untuk versi yang ingin Anda perbarui.

  4. Menggunakan contoh kode berikut, buat file changeset dalam format JSON. Dalam contoh, ganti your-product-ID dengan ID produk yang Anda peroleh pada langkah 1. Ganti your-release-notes dengan catatan rilis Anda. Ganti your-delivery-option-ID dengan ID opsi pengiriman yang Anda peroleh pada langkah 3. Ganti your-usage-instructions dengan instruksi penggunaan Anda.

    [
    {
        "ChangeType": "UpdateDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "Version": {
                "ReleaseNotes": "your-release-notes"
            },
            "DeliveryOptions": [
                {
                    "Id": "your-delivery-option-ID",
                    "Details": {
                        "Ec2ImageBuilderComponentDeliveryOptionDetails": {
                            "UsageInstructions": "your-usage-instructions"
                        }
                    }
                }
            ]
        }
    }
]

  5. Simpan file changeset dengan namaupdateVersionInfo.json.

  6. Di terminal Anda atau AWS CloudShell, jalankan perintah berikut:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json

Per start-change-set intah akan mengembalikan ChangeSetId nilai. Untuk memantau kumpulan perubahan, lihatMemantau set perubahan.

Membatasi versi produk komponen Image Builder

Membatasi versi membuatnya tidak tersedia untuk pembeli. Anda dapat membatasi versi produk komponen Image Builder AWS Marketplace menggunakan API AWS Marketplace Katalog. Anda harus menyimpan setidaknya satu versi produk Anda tanpa batasan AWS Marketplace. Anda tidak dapat membatasi akses ke satu-satunya versi publik.

Untuk memperbarui informasi tentang versi yang sudah ada

  1. Dari Portal Manajemen AWS Marketplace, dapatkan ID Produk.

    1. Buka Portal Manajemen AWS Marketplace dan masuk ke akun penjual Anda.

    2. Pada menu Produk, pilih Server.

    3. Pada halaman produk Server, pilih produk.

    4. Dalam Ringkasan Produk, salin ID Produk.

  2. Di terminal Anda, jalankan perintah berikut. Dalam perintah, ganti your-product-ID dengan ID yang Anda peroleh pada langkah 1.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

  3. Dalam output yang dikembalikan, buka Versions bagianDetailsDocument,. Salin Id nilaiDeliveryOptions, untuk versi yang ingin Anda perbarui.

  4. Menggunakan contoh kode berikut, buat file changeset dalam format JSON. Dalam contoh, ganti your-product-ID dengan ID produk yang Anda peroleh pada langkah 1. Ganti your-delivery-option-ID dengan ID opsi pengiriman yang Anda peroleh pada langkah 3.

    [
    {
        "ChangeType": "RestrictDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "DeliveryOptionIds": [
                "your-delivery-option-ID"
            ]
        }
    }
]

  5. Simpan file changeset dengan namarestrictec2ibversion.json.

  6. Di terminal Anda atau AWS CloudShell, jalankan perintah berikut:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json

Per start-change-set intah akan mengembalikan ChangeSetId nilai. Untuk memantau kumpulan perubahan, lihatMemantau set perubahan.

Memantau set perubahan

Per start-change-set intah akan mengembalikan ChangeSetId nilai. Anda dapat memantau kemajuan set perubahan dengan cara berikut:

  • Jalankan perintah berikut di terminal Anda. Dalam perintah. ganti changeset-ID dengan ChangeSetId nilai yang dikembalikan oleh start-change-set perintah.

    aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id changesetID

  • Lihat status permintaan pada tab Permintaan di Portal AWS Marketplace Manajemen.

Mengamankan unduhan perangkat lunak

Untuk melindungi kekayaan intelektual perangkat lunak ISV dan memastikan pengiriman perangkat lunak yang stabil dan konsisten kepada AWS Marketplace pembeli, modul parsing S3Download dan WebDownload tindakan AWS Marketplace secara otomatis di komponen Anda. File yang direferensikan kemudian disimpan dengan aman di bucket Amazon S3 pribadi yang dikelola oleh AWS Marketplace. Untuk memilih keluar dari proses penyerapan ini dan mengelola unduhan perangkat lunak secara independen, jalankan skrip bash yang menggunakan perintah wget atau curl unduh.