Pembuatan versi semantik di Image Builder - EC2 Image Builder
Menggunakan referensi versiPola referensi versi yang tersediaSumber daya yang mengembalikan referensi versi

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

Pembuatan versi semantik di Image Builder

Image Builder menggunakan versi semantik untuk mengatur sumber daya dan memastikan bahwa mereka memiliki keunikan. IDs Versi semantik memiliki empat node:

<major>. <minor>. <patch>/<build>

Anda dapat menetapkan nilai untuk tiga yang pertama, dan dapat memfilter semuanya.

Versi semantik disertakan dalam Nama Sumber Daya Amazon (ARN) setiap objek, pada tingkat yang berlaku untuk objek tersebut sebagai berikut:

  1. Versionless ARNs dan Name ARNs tidak menyertakan nilai spesifik di salah satu node. Node ditinggalkan seluruhnya, atau ditentukan sebagai wildcard, misalnya: x.x.x.

  2. Versi hanya ARNs memiliki tiga node pertama:<major>. <minor>. <patch>

  3. Versi build ARNs memiliki keempat node, dan arahkan ke build tertentu untuk versi objek tertentu.

Penugasan: Untuk tiga node pertama Anda dapat menetapkan nilai integer positif, atau nol, dengan batas atas 2 ^ 30-1, atau 1073741823 untuk setiap node. Image Builder secara otomatis menetapkan nomor build ke node keempat.

Pola: Anda dapat menggunakan pola numerik apa pun yang mematuhi persyaratan penugasan untuk node yang dapat Anda tetapkan. Misalnya, Anda dapat memilih pola versi perangkat lunak, seperti 1.0.0, atau tanggal, seperti 2021.01.01.

Seleksi: Dengan versi semantik, Anda memiliki fleksibilitas untuk menggunakan wildcard (x) untuk menentukan versi atau node terbaru saat memilih gambar dasar atau komponen untuk resep Anda. Saat Anda menggunakan wildcard di node apa pun, semua node di sebelah kanan wildcard pertama juga harus wildcard.

Misalnya, mengingat versi terbaru berikut: 2.2.4, 1.7.8, dan 1.6.8, pemilihan versi menggunakan wildcard menghasilkan hasil sebagai berikut:

  • x.x.x= 2.2.4

  • 1.x.x= 1.7.8

  • 1.6.x= 1.6.8

  • x.2.xtidak valid, dan menghasilkan kesalahan

  • 1.x.8tidak valid, dan menghasilkan kesalahan

Menggunakan referensi versi

Referensi versi adalah string ready-to-use ARN yang menggabungkan pola wildcard berdasarkan versi semantik sumber daya yang Anda buat atau ambil. Alih-alih menulis kode khusus untuk mengurai ARNs dan menyisipkan wildcard, Image Builder melakukan ini untuk Anda.

Saat Anda membuat atau mengambil sumber daya Image Builder, Image Builder secara otomatis menyediakan pola versi wildcard ARNs yang telah dibuat sebelumnya di objek. latestVersionReferences Ini menghilangkan kebutuhan untuk mengurai dan merekonstruksi secara manual ARNs saat Anda ingin mereferensikan sumber daya menggunakan pola versi wildcard.

Misalnya, saat Anda membuat komponen dengan versi1.2.3, Image Builder mengembalikan:


{
    "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3/1",
    "latestVersionReferences": {
        "latestVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/x.x.x",
        "latestMajorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.x.x",
        "latestMinorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.x",
        "latestPatchVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3"
    }
}

Pola referensi versi yang tersedia

latestVersionReferencesObjek berisi empat pola ARN:

  • latestVersionArn (x.xx) - Selalu menyelesaikan ke versi terbaru absolut.

  • atestMajorVersionArn (1.xx) - Menyelesaikan ke versi minor dan patch terbaru dalam versi utama.

  • latestMinorVersionArn (1.2.x) - Menyelesaikan ke versi patch terbaru dalam versi minor tertentu.

  • latestPatchVersionArn (1.2.3) - Mereferensikan versi semantik tertentu dan menyelesaikan ke versi build terbaru untuk sumber daya yang mendukung beberapa versi build.

Sumber daya yang mengembalikan referensi versi

Referensi versi dikembalikan oleh Create dan Get APIs untuk semua sumber daya Image Builder berversi:

  • Komponen -CreateComponent, GetComponent

  • Resep gambar -CreateImageRecipe, GetImageRecipe

  • Resep wadah -CreateContainerRecipe, GetContainerRecipe

  • Gambar -CreateImage, GetImage

  • Alur kerja -CreateWorkflow, GetWorkflow

Catatan: Untuk alur kerja yang dikelola Pembuat Gambar, hanya latestVersionArn (x.x.x) ditampilkan, karena Image Builder mengharuskan Anda untuk selalu menggunakan alur kerja yang dikelola Pembuat Gambar versi terbaru.