AWS Proton parameter - AWS Proton
Jenis parameterMenggunakan parameter

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

AWS Proton parameter

Anda dapat menentukan dan menggunakan parameter dalam infrastruktur Anda sebagai file kode (IAc) untuk membuatnya fleksibel dan dapat digunakan kembali. Anda membaca nilai parameter dalam file IAC Anda dengan mengacu pada nama parameter di namespace AWS Proton parameter. AWS Proton menyuntikkan nilai parameter ke dalam file IAc yang dirender yang dihasilkannya selama penyediaan sumber daya. Untuk memproses parameter AWS CloudFormation IAc, AWS Proton gunakan Jinja. Untuk memproses parameter Terraform IAc, AWS Proton buat file nilai parameter Terraform dan bergantung pada kemampuan parametriisasi yang dibangun ke dalam HCL.

DenganCodeBuildpenyediaan, AWS Proton menghasilkan file input yang dapat diimpor kode Anda. File tersebut adalah file JSON atau HCL, tergantung pada properti di manifes template Anda. Untuk informasi selengkapnya, lihat CodeBuild rincian parameter penyediaan dan contoh.

Anda dapat merujuk ke parameter di lingkungan, layanan, dan file IAc komponen atau kode penyediaan dengan persyaratan berikut:

  • Panjang setiap nama parameter tidak melebihi 100 karakter.

  • Panjang namespace parameter dan nama sumber daya digabungkan tidak melebihi batas karakter untuk nama sumber daya.

AWS Proton penyediaan gagal jika kuota ini terlampaui.

Jenis parameter

Jenis parameter berikut tersedia untuk Anda untuk referensi dalam file AWS Proton IAC:

Parameter masukan

Lingkungan dan instance layanan dapat mengambil parameter input yang Anda tentukan dalam file skema yang Anda kaitkan dengan template lingkungan atau layanan. Anda dapat merujuk ke parameter input sumber daya dalam file IAC sumber daya. File komponen IAC dapat merujuk ke parameter input dari instance layanan tempat komponen dilampirkan.

AWS Proton memeriksa nama parameter input terhadap file skema Anda, dan mencocokkannya dengan parameter yang direferensikan dalam file IAC Anda untuk menyuntikkan nilai input yang Anda berikan dalam file spesifikasi selama penyediaan sumber daya.

Parameter keluaran

Anda dapat menentukan output di salah satu file IAC Anda. Output dapat berupa, misalnya, nama, ID, atau ARN dari salah satu sumber daya yang disediakan template, atau dapat menjadi cara untuk melewati salah satu input template. Anda dapat merujuk ke output ini dalam file IAC dari sumber daya lain.

Dalam file CloudFormation IAC, tentukan parameter output di Outputs: blok. Dalam file Terraform IAc, tentukan setiap parameter output menggunakan pernyataan. output

Parameter sumber daya

AWS Proton secara otomatis membuat parameter AWS Proton sumber daya. Parameter ini mengekspos properti dari objek AWS Proton sumber daya. Contoh parameter sumber daya adalahenvironment.name.

Menggunakan AWS Proton parameter dalam file IAC Anda

Untuk membaca nilai parameter dalam file IAc, Anda merujuk ke nama parameter di namespace AWS Proton parameter. Untuk file AWS CloudFormation IAc, Anda menggunakan sintaks Jinja dan mengelilingi parameter dengan pasangan kurawal kurawal dan tanda kutip.

Tabel berikut menunjukkan sintaks referensi untuk setiap bahasa template yang didukung, dengan contoh.

Bahasa template Sintaks Contoh: input lingkungan bernama “VPC”

CloudFormation

"{{ parameter-name }}"

"{{ environment.inputs.VPC }}"

Terraform

var.parameter-name

var.environment.inputs.VPC

Definisi variabel Terraform yang dihasilkan
catatan

Jika Anda menggunakan parameter CloudFormation dinamis dalam file IAC Anda, Anda harus menghindarinya untuk mencegah kesalahan salah tafsir Jinja. Lihat informasi yang lebih lengkap di Pemecahan Masalah AWS Proton

Tabel berikut mencantumkan nama namespace untuk semua parameter AWS Proton sumber daya. Setiap jenis file template dapat menggunakan subset yang berbeda dari namespace parameter.

Berkas templat Jenis parameter Nama parameter Deskripsi

Environment

sumber daya

environment.name

Nama lingkungan

input

environment.inputs.input-name

Masukan lingkungan yang ditentukan skema

Layanan

sumber daya

environment.name

environment.account_id

Nama dan Akun AWS ID lingkungan

output

environment.outputs.output-name

Output file iAc lingkungan

sumber daya

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nama layanan dan repositori kode

sumber daya

service_instance.name

Nama contoh layanan

input

service_instance.inputs.input-name

Masukan contoh layanan yang ditentukan skema

sumber daya

service_instance.components.default.name

Nama komponen default terlampir

output

service_instance.components.default.outputs.output-name

Output file iAc komponen default terlampir

Alur

sumber daya

service_instance.environment.name

service_instance.environment.account_id

Nama dan Akun AWS ID lingkungan instance layanan

output

service_instance.environment.outputs.output-name

Output file iAc lingkungan contoh layanan

input

pipeline.inputs.input-name

Input pipa yang ditentukan skema

sumber daya

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nama layanan dan repositori kode

input

service_instance.inputs.input-name

Masukan contoh layanan yang ditentukan skema

koleksi

{% for service_instance in service_instances %}...{% endfor %}

Kumpulan instance layanan yang dapat Anda lalui

Komponen

sumber daya

environment.name

environment.account_id

Nama lingkungan dan ID Akun AWS akun

output

environment.outputs.output-name

Output file iAc lingkungan

sumber daya

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nama layanan dan repositori kode (komponen terlampir)

sumber daya

service_instance.name

Nama instance layanan (komponen terlampir)

input

service_instance.inputs.input-name

Input instance layanan yang ditentukan skema (komponen terlampir)

sumber daya

component.name

Nama komponen

Untuk informasi dan contoh selengkapnya, lihat subtopik tentang parameter dalam file templat IAC untuk berbagai jenis sumber daya dan bahasa templat.

Topik