Fonctions

Vous pouvez utiliser des fonctions dans vos fichiers de configuration pour renseigner les valeurs des propriétés de ressource à l'aide des informations issues d'autres ressources ou de paramètres d'option de configuration Elastic Beanstalk. Elastic Beanstalk prend en charge les fonctions AWS CloudFormation (Ref, Fn::GetAtt, Fn::Join) et une fonction spécifique à Elastic Beanstalk, Fn::GetOptionSetting.

Réf

Utilisez Ref pour récupérer la représentation de chaîne par défaut d'une ressource AWS. La valeur renvoyée par Ref dépend du type de ressource et parfois d'autres facteurs également. Par exemple, un groupe de sécurité (AWS::EC2::SecurityGroup) renvoie soit le nom, soit l'ID du groupe de sécurité, selon que le groupe de sécurité se trouve dans un Amazon Virtual Private Cloud (Amazon VPC) par défaut, dans EC2-Classic ou dans un VPC personnalisé.

{ "Ref" : "resource name" }

Note

Pour plus d'informations sur chaque type de ressource, y compris la ou les valeurs de renvoi de Ref, consultez Référence des types de ressources AWS dans le Guide de l'utilisateur AWS CloudFormation.

À partir de l'exemple de hook de cycle de vie Auto Scaling :

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

Vous pouvez également utiliser Ref pour récupérer la valeur d'un paramètre AWS CloudFormation défini ailleurs dans le même fichier ou dans un fichier de configuration différent.

Fn::GetAtt

Utilisez Fn::GetAtt pour récupérer la valeur d'un attribut sur une ressource AWS.

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

À partir de l'exemple de hook de cycle de vie Auto Scaling :

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

Pour plus d'informations, consultez Fn::GetAtt.

Fn::Join

Utilisez Fn::Join pour associer des chaînes avec un délimiteur. Les chaînes peuvent être codées en dur ou utiliser le résultat de Fn::GetAtt ou Ref.

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

Pour plus d'informations, consultez Fn::Join.

Fn::GetOptionSetting

Utilisez Fn::GetOptionSetting pour récupérer la valeur d'un paramètre d'option de configuration appliqué à l'environnement.

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

À partir de l'exemple stockage de clés privées :

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"