Section Transform du modèle CloudFormation

La section facultative Transform spécifie une ou plusieurs macros que CloudFormation utilise pour traiter votre modèle d’une certaine manière.

Les macros peuvent effectuer des tâches simples telles que la recherche et le remplacement de texte, ou elles peuvent transformer de manière plus importante l’ensemble du modèle. CloudFormation exécute les macros dans l’ordre dans lequel elles sont spécifiées. Lorsque vous créez un jeu de modifications, CloudFormation génère un jeu de modifications qui inclut le contenu du modèle traité. Vous pouvez alors passer en revue les modifications et exécuter le jeu de modifications. Pour plus d’informations sur le fonctionnement des macros, consultez Effectuez un traitement personnalisé sur les modèles CloudFormation à l’aide de macros de modèle.

CloudFormation prend également en charge les transformations, qui sont des macros hébergées par CloudFormation. CloudFormation traite ces transformations de la même manière que les macros que vous créez en termes d’ordre d’exécution et de portée. Pour plus d’informations, consultez Référence des transformations.

Pour déclarer plusieurs macros, utilisez un format de liste et spécifiez une ou plusieurs macros.

Par exemple, dans l’exemple de modèle ci-dessous, CloudFormation évalue MyMacro puis AWS::Serverless, qui peuvent toutes deux traiter le contenu du modèle complet, en raison de leur insertion dans la section Transform.

# Start of processable content for MyMacro and AWS::Serverless
Transform:
  - MyMacro
  - 'AWS::Serverless'
Resources:
  WaitCondition:
    Type: AWS::CloudFormation::WaitCondition
  MyBucket:
    Type: AWS::S3::Bucket
    Properties: 
      BucketName: amzn-s3-demo-bucket
      Tags: [{"key":"value"}]
      CorsConfiguration: []
  MyEc2Instance:
    Type: AWS::EC2::Instance 
    Properties:
      ImageId: ami-1234567890abcdef0
# End of processable content for MyMacro and AWS::Serverless