Funktionen

Sie können Funktionen in den Konfigurationsdateien verwenden, um Werte der Ressourceneigenschaften mit Informationen aus anderen Ressourcen oder aus den Einstellungen der Konfigurationsoptionen von Elastic Beanstalk zu füllen. Elastic Beanstalk unterstützt AWS CloudFormation-Funktionen (Ref, Fn::GetAtt, Fn::Join) und eine Elastic-Beanstalk-spezifische Funktion, Fn::GetOptionSetting.

Punkt

Mit Ref wird die standardmäßige Zeichenfolgendarstellung einer AWS-Ressource abgerufen. Der von Ref zurückgegebene Wert hängt vom Ressourcentyp – und gelegentlich auch von weiteren Faktoren – ab. Beispielsweise gibt eine Sicherheitsgruppe (AWS::EC2::SecurityGroup) entweder den Namen oder die ID der Sicherheitsgruppe zurück, je nachdem, ob sie sich in einer Standard-Amazon Virtual Private Cloud (Amazon VPC), in EC2 Classic oder einer benutzerdefinierten VPC befindet.

{ "Ref" : "resource name" }

Anmerkung

Weitere Informationen zu den einzelnen Ressourcentypen einschließlich der Rückgabewerte von Ref finden Sie unter AWS-Ressourcentypen – Referenz im AWS CloudFormation-Benutzerhandbuch.

Aus dem Beispiel Auto Scaling-Lebenszyklus-Hook:

Resources:
  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      AutoScalingGroupName: { "Ref" : "AWSEBAutoScalingGroup" }

Mit Ref lässt sich auch der AWS CloudFormation-Parameterwert abrufen, der entweder an anderer Stelle in derselben Datei oder in einer anderen Konfigurationsdatei definiert ist.

Fn::GetAtt

Mit Fn::GetAtt wird der Wert eines AWS-Ressourcenattributs abgerufen.

{ "Fn::GetAtt" : [ "resource name", "attribute name"] }

Aus dem Beispiel Auto Scaling-Lebenszyklus-Hook:

Resources:
  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      RoleARN: { "Fn::GetAtt" : [ "hookrole", "Arn"] }

Weitere Informationen finden Sie unter Fn::GetAtt.

Fn::Join

Mit Fn::Join werden Zeichenfolgen mit einem Trennzeichen zusammengefasst. Die Zeichenfolgen können hartcodiert sein oder die Ausgabe von Fn::GetAtt oder Ref verwenden.

{ "Fn::Join" : [ "delimiter", [ "string1", "string2" ] ] }

Weitere Informationen finden Sie unter Fn::Join.

Fn::GetOptionSetting

Mit Fn::GetOptionSetting wird der Einstellungswert einer Konfigurationsoption abgerufen, die für die Umgebung gilt.

"Fn::GetOptionSetting":
  Namespace: "namespace"
  OptionName: "option name"
  DefaultValue: "default value"

Aus dem Beispiel storing private keys:

Resources:
  AWSEBAutoScalingGroup:
    Metadata:
      AWS::CloudFormation::Authentication:
        S3Auth:
          type: "s3"
          buckets: ["elasticbeanstalk-us-west-2-123456789012"]
          roleName: 
            "Fn::GetOptionSetting": 
              Namespace: "aws:autoscaling:launchconfiguration"
              OptionName: "IamInstanceProfile"
              DefaultValue: "aws-elasticbeanstalk-ec2-role"