Funzioni

È possibile utilizzare le funzioni nei file di configurazione per inserire i valori per le proprietà delle risorse con informazioni provenienti da altre risorse o dalle impostazioni delle opzioni di configurazione di Elastic Beanstalk. Elastic Beanstalk supporta le funzioni AWS CloudFormation (Ref, Fn::GetAtt, Fn::Join) e una funzione specifica di Elastic Beanstalk, Fn::GetOptionSetting.

Ref

Utilizza Ref per recuperare la rappresentazione della stringa predefinita di una risorsa AWS. Il valore restituito da Refdipende dal tipo di risorsa e talvolta dipende anche da altri fattori. Ad esempio, un gruppo di sicurezza (AWS::EC2::SecurityGroup) restituisce il nome o l'ID del gruppo di sicurezza, a seconda che il gruppo di sicurezza si trovi in un Amazon Virtual Private Cloud (Amazon VPC) di default, EC2 classic o in un VPC personalizzato.

{ "Ref" : "resource name" }

Nota

Per dettagli su ciascun tipo di risorsa, inclusi i valori restituiti di Ref, consultare Informazioni di riferimento dei tipi di risorse AWS nella Guida per l'utente di AWS CloudFormation.

Dall'Hook del ciclo di vita Auto Scaling di esempio:

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

Inoltre, è possibile utilizzare Ref per recuperare il valore di un parametro AWS CloudFormation definito altrove nello stesso file o in un file di configurazione differente.

Fn::GetAtt

Usa Fn::GetAtt per recuperare il valore di un attributo su una risorsa AWS.

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

Dall'Hook del ciclo di vita Auto Scaling di esempio:

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

Per ulteriori informazioni, consulta Fn::GetAtt.

Fn::Join

Utilizza Fn::Join per abbinare le stringhe a un delimitatore. Le stringhe possono essere hardcoded oppure utilizzare l'output da Fn::GetAtt o Ref.

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

Per ulteriori informazioni, consulta Fn::Join.

Fn::GetOptionSetting

Usa Fn::GetOptionSetting per recuperare il valore di un'impostazione di un'opzione di configurazione applicata all'ambiente.

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

Dall'esempio archiviazione delle chiavi private:

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"