Details und Beispiele für Service- CloudFormation IaC-Dateiparameter

Sie können Parameter in Ihren Service- und Pipeline-Infrastruktur-as-Code (IaC)-Dateien definieren und referenzieren. Eine detaillierte Beschreibung der AWS Proton Parameter, Parametertypen, des Parameter-Namespace und der Verwendung von Parametern in Ihren IaC-Dateien finden Sie unter AWS Proton -Parameter.

Definieren von Serviceparametern

Sie können sowohl Eingabe- als auch Ausgabeparameter für Service-IaC-Dateien definieren.

• Eingabeparameter – Definieren Sie Eingabeparameter der Service-Instance in Ihrer Schemadatei .

  Die folgende Liste enthält Beispiele für Serviceeingabeparameter für typische Anwendungsfälle.

  • Port

  • Aufgabengröße

  • Image

  • Gewünschte Anzahl

  • Docker-Datei

  • Einheitentestbefehl

  Sie geben Werte für Eingabeparameter an, wenn Sie einen Service erstellen:

  • Verwenden Sie die -Konsole, um ein schemabasiertes Formular auszufüllen, das AWS Proton bereitstellt.

  • Verwenden Sie die CLI, um eine Spezifikation bereitzustellen, die die Werte enthält.

• Ausgabeparameter – Definieren Sie Service-Instance-Ausgaben in Ihren Service-IaC-Dateien. Sie können dann in IaC-Dateien anderer Ressourcen auf diese Ausgaben verweisen.

Lesen von Parameterwerten in Service-IaC-Dateien

Sie können Parameter im Zusammenhang mit dem Service und anderen Ressourcen in Service-IaC-Dateien lesen. Sie lesen einen Parameterwert, indem Sie im AWS Proton Parameter-Namespace auf den Namen des Parameters verweisen.

• Eingabeparameter – Lesen Sie einen Service-Instance-Eingabewert, indem Sie auf verweisenservice_instance.inputs.input-name.

• Ressourcenparameter – Lesen Sie AWS Proton Ressourcenparameterservice_instance.name, indem Sie auf Namen wie service.name, und verweisenenvironment.name.

• Ausgabeparameter – Lesen Sie Ausgaben anderer Ressourcen, indem Sie auf environment.outputs.output-name oder verweisenservice_instance.components.default.outputs.output-name.

Beispiel für eine ServiceIaC-Datei mit Parametern

Das folgende Beispiel ist ein Ausschnitt aus einer CloudFormation IaC-Datei. Der environment.outputs. Namespace bezieht sich auf Ausgaben aus der IaC-Datei der Umgebung. Der service_instance.inputs. Namespace bezieht sich auf Eingabeparameter der Service-Instance. Die -service_instance.nameEigenschaft bezieht sich auf einen - AWS Proton Ressourcenparameter.

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