Detail parameter file layanan CloudFormation IAC dan contoh

Anda dapat menentukan dan mereferensikan parameter dalam layanan dan infrastruktur pipa sebagai file kode (IAc). Untuk penjelasan rinci tentang AWS Proton parameter, jenis parameter, namespace parameter, dan cara menggunakan parameter dalam file IAC Anda, lihat. AWS Proton parameter

Tentukan parameter layanan

Anda dapat menentukan parameter input dan output untuk file iAC layanan.

• Parameter input - Tentukan parameter input instance layanan dalam file skema Anda.

  Daftar berikut mencakup contoh parameter input layanan untuk kasus penggunaan umum.

  • Port

  • Ukuran tugas

  • Citra

  • Jumlah yang diinginkan

  • Berkas Docker

  • Perintah uji unit

  Anda memberikan nilai untuk parameter masukan saat membuat layanan:

  • Gunakan konsol untuk mengisi formulir berbasis skema yang AWS Proton menyediakan.

  • Gunakan CLI untuk memberikan spesifikasi yang menyertakan nilai.

• Parameter keluaran — Tentukan output instance layanan dalam file iAC layanan Anda. Anda kemudian dapat merujuk ke output ini dalam file IAC dari sumber daya lain.

Baca nilai parameter dalam file iAc layanan

Anda dapat membaca parameter yang terkait dengan layanan dan sumber daya lain dalam file iAC layanan. Anda membaca nilai parameter dengan mereferensikan nama parameter di namespace AWS Proton parameter.

• Parameter input — Baca nilai input instance layanan dengan referensiservice_instance.inputs.input-name.

• Parameter sumber daya — Baca parameter AWS Proton sumber daya dengan mereferensikan nama sepertiservice.name,service_instance.name, danenvironment.name.

• Parameter keluaran — Baca output sumber daya lain dengan referensi environment.outputs.output-name atau. service_instance.components.default.outputs.output-name

Contoh layanan file iAc dengan parameter

Contoh berikut adalah cuplikan dari file layanan CloudFormation IAc. environment.outputs.Namespace mengacu pada output dari file iAc lingkungan. service_instance.inputs.Namespace mengacu pada parameter input instance layanan. service_instance.nameProperti mengacu pada parameter AWS Proton sumber daya.

Resources:
  StoreServiceInstanceInputValue:
    Type: AWS::SSM::Parameter
    Properties:
      Type: String
      Value: "{{ service.name }} {{ service_instance.name }} {{ service_instance.inputs.my_sample_service_instance_required_input }} {{ service_instance.inputs.my_sample_service_instance_optional_input }} {{ environment.outputs.MySampleInputValue }} {{ environment.outputs.MyOtherSampleInputValue }}"
              #  resource parameter references               # input parameter references                                                                                                                    # output references to an environment infrastructure as code file
Outputs:
  MyServiceInstanceParameter:                                                         # output definition
    Value: !Ref StoreServiceInstanceInputValue 
  MyServiceInstanceRequiredInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_required_input }}"  # input parameter reference
  MyServiceInstanceOptionalInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_optional_input }}"  # input parameter reference
  MyServiceInstancesEnvironmentSampleOutputValue:                                     # output definition
    Value: "{{ environment.outputs.MySampleInputValue }}"                             # output reference to an environment IaC file
  MyServiceInstancesEnvironmentOtherSampleOutputValue:                                # output definition
    Value: "{{ environment.outputs.MyOtherSampleInputValue }}"                        # output reference to an environment IaC file