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

Kelola parameter AWSTOE komponen dengan EC2 Image Builder

Anda dapat mengelola AWSTOE komponen, termasuk membuat dan menyetel parameter komponen, langsung dari konsol EC2 Image Builder, atau dengan AWS CLI menggunakan perintah, atau salah satu SDK Image Builder. Di bagian ini, kita akan membahas pembuatan dan penggunaan parameter di komponen Anda, dan mengatur parameter komponen melalui konsol dan AWS CLI perintah Image Builder.

Gunakan parameter dalam dokumen komponen YAMAL Anda

Untuk membangun komponen, sediakan dokumen komponen aplikasi YAMG. Ini mewakili fase dan langkah yang Anda butuhkan untuk membuat komponen. Resep yang mereferensikan komponen dapat mengatur parameter untuk menyesuaikan nilai saat runtime, dengan nilai default yang berlaku jika parameter tidak disetel ke nilai tertentu.

Buat dokumen komponen dengan parameter input

Bagian ini menunjukkan kepada Anda cara menentukan dan menggunakan parameter input dalam dokumen komponen YAMAL Anda.

Untuk membuat dokumen komponen aplikasi YAMG yang menggunakan parameter dan menjalankan perintah di build Image Builder atau instance pengujian, ikuti langkah-langkah yang sesuai dengan sistem operasi image Anda:

Linux

Membuat dokumen komponen YAMG

Gunakan alat pengeditan file untuk membuat file bernamahello-world-test.yaml. Sertakan konten berikut:

# Document Start
# 
name: "HelloWorldTestingDocument-Linux"
description: "Hello world document to demonstrate parameters."
schemaVersion: 1.0
parameters:
  - MyInputParameter:
      type: string
      default: "It's me!"
      description: This is an input parameter.
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Build phase. My input parameter value is {{ MyInputParameter }}"

  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Validate phase. My input parameter value is {{ MyInputParameter }}"

  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Test phase. My input parameter value is {{ MyInputParameter }}"
# Document End

Tip

Gunakan alat seperti Validator YAMG online ini, atau ekstensi lint YAMG di lingkungan kode Anda untuk memverifikasi bahwa YAMAL Anda terbentuk dengan baik.

Windows

Membuat dokumen komponen YAMG

Gunakan alat pengeditan file untuk membuat file bernamahello-world-test.yaml. Sertakan konten berikut:

# Document Start
# 
name: "HelloWorldTestingDocument-Windows"
description: "Hello world document to demonstrate parameters."
schemaVersion: 1.0
parameters:
  - MyInputParameter:
      type: string
      default: "It's me!"
      description: This is an input parameter.
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Build phase. My input parameter value is {{ MyInputParameter }}"

  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Validate phase. My input parameter value is {{ MyInputParameter }}"

  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Test phase. My input parameter value is {{ MyInputParameter }}"
# Document End

Tip

Gunakan alat seperti Validator YAMG online ini, atau ekstensi lint YAMG di lingkungan kode Anda untuk memverifikasi bahwa YAMAL Anda terbentuk dengan baik.

Untuk informasi selengkapnya tentang fase, langkah, dan sintaks untuk dokumen komponen AWSTOE aplikasi YAMAL, lihat Menggunakan dokumen di. AWSTOE Untuk informasi selengkapnya tentang parameter dan persyaratannya, lihat Parameter bagian Tentukan dan referensi variabel di AWSTOE halaman.

Buat komponen dari dokumen komponen YAMG

Metode apa pun yang Anda gunakan untuk membuat AWSTOE komponen, dokumen komponen aplikasi YAMAL selalu diperlukan sebagai baseline.

Mengatur parameter komponen dalam resep Image Builder (konsol)

Pengaturan parameter komponen bekerja sama untuk resep gambar dan resep wadah. Saat membuat resep baru, atau resep versi baru, Anda memilih komponen mana yang akan disertakan dari komponen Build dan daftar komponen Uji. Daftar komponen mencakup komponen yang berlaku untuk sistem operasi dasar yang Anda pilih untuk gambar Anda.

Setelah Anda memilih komponen, itu ditampilkan di bagian Komponen yang dipilih, langsung di bawah daftar komponen. Opsi konfigurasi ditampilkan untuk setiap komponen yang dipilih. Jika komponen Anda memiliki parameter input yang ditentukan, parameter tersebut ditampilkan sebagai bagian yang dapat diperluas yang disebut Parameter input.

Pengaturan parameter berikut ditampilkan untuk setiap parameter yang ditentukan untuk komponen Anda: