Details und Beispiele zu den Parametern der CloudFormation Service-IaC-Datei - AWS Proton
Definieren Sie ServiceparameterLesen Sie Parameterwerte in Service-IaC-DateienBeispiel für eine Service-IaC-Datei mit Parametern

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Details und Beispiele zu den Parametern der CloudFormation Service-IaC-Datei

Sie können Parameter in Ihrer Service- und Pipeline-Infrastruktur als Codedateien (IaC) definieren und referenzieren. Eine ausführliche 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 Sie Serviceparameter

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

  • Eingabeparameter — Definieren Sie Eingabeparameter für die Dienstinstanz in Ihrer Schemadatei.

    Die folgende Liste enthält Beispiele für Service-Eingabeparameter für typische Anwendungsfälle.

    • Port

    • Aufgabengröße

    • Image

    • Gewünschte Anzahl

    • Docker-Datei

    • Befehl zum Komponententest

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

    • Verwenden Sie die Konsole, um ein schemabasiertes Formular auszufüllen, das AWS Proton Folgendes bietet:

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

  • Ausgabeparameter — Definieren Sie die Ausgaben der Serviceinstanz in Ihren Service-IaC-Dateien. Sie können dann in IaC-Dateien anderer Ressourcen auf diese Ausgaben verweisen.

Lesen Sie Parameterwerte in Service-IaC-Dateien

Sie können Parameter lesen, die sich auf den Dienst und andere Ressourcen beziehen, in Service-IaC-Dateien. Sie lesen einen Parameterwert, indem Sie im Parameter-Namespace auf den Namen des AWS Proton Parameters verweisen.

  • Eingabeparameter — Lesen Sie den Eingabewert einer Dienstinstanz durch Verweisen. service_instance.inputs.input-name

  • Ressourcenparameter — Lesen Sie AWS Proton Ressourcenparameter, indem Sie auf Namen wie service.nameservice_instance.name, und verweisen. environment.name

  • Ausgabeparameter — Lesen Sie Ausgaben anderer Ressourcen, indem Sie auf oder verweisenenvironment.outputs.output-name. service_instance.components.default.outputs.output-name

Beispiel für eine Service-IaC-Datei mit Parametern

Das folgende Beispiel ist ein Ausschnitt aus einer CloudFormation Service-IaC-Datei. Der environment.outputs. Namespace bezieht sich auf Ausgaben aus der IaC-Umgebungsdatei. Der service_instance.inputs. Namespace bezieht sich auf Eingabeparameter der Dienstinstanz. Die service_instance.name Eigenschaft 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