Transform section pour les CloudFormation modèles

La Transform section facultative indique une ou plusieurs macros CloudFormation utilisées pour traiter votre modèle d'une manière ou d'une autre.

Les macros peuvent effectuer des tâches simples telles que rechercher et remplacer du texte, ou elles peuvent apporter des transformations plus importantes à 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 ensemble de modifications, il en CloudFormation génère un 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, consultezEffectuez un traitement personnalisé sur les CloudFormation modèles à l'aide de macros de modèles.

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 toutes les macros que vous créez en termes d'ordre d'exécution et de portée. Pour de plus amples informations, veuillez consulter Référence sur les 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 traite le contenu de l'ensemble du modèle en raison de son inclusion dans la Transform section.

# 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