能否在AWS CloudFormation YAML/JSON模板中遍历数组创建重复资源？

绝对可以！当你需要创建大量结构相似的CloudFormation资源（比如AppSync Resolver）时，通过遍历数组来动态生成资源是大幅简化模板、提升可读性和可维护性的最优方案。我在多个AppSync项目中都用过这个技巧，原本几百行重复代码的模板直接压缩到几十行，后续修改也只需要调整数组里的配置，不用逐个修改资源。

方法1：使用CloudFormation Fn::ForEach（推荐，2023+支持） #

这是CloudFormation在2023年推出的官方遍历功能，无需额外依赖，语法简洁。使用前需要声明AWS::LanguageExtensions Transform，因为这属于CFN的扩展功能。

示例模板 #

AWSTemplateFormatVersion: "2010-09-09"
# 必须声明这个Transform才能启用Fn::ForEach
Transform: AWS::LanguageExtensions

Parameters:
  GraphQlApiId:
    Type: String
    Description: 你的AppSync API ID
  GraphQlSchemaName:
    Type: String
    Description: 依赖的GraphQL Schema资源名称
  DefaultDataSourceName:
    Type: String
    Description: 所有Resolver共用的数据源名称

# 定义所有Resolver的差异化配置数组
Mappings:
  ResolverConfigs:
    Items:
      - FieldName: "addPosts"
        TypeName: "Mutation"
        RequestTemplatePath: "s3://your-template-bucket/resolvers/addPosts-request.vtl"
      - FieldName: "getPosts"
        TypeName: "Query"
        RequestTemplatePath: "s3://your-template-bucket/resolvers/getPosts-request.vtl"
      - FieldName: "updatePosts"
        TypeName: "Mutation"
        RequestTemplatePath: "s3://your-template-bucket/resolvers/updatePosts-request.vtl"
      # 可以继续添加更多Resolver配置

Resources:
  # 遍历ResolverConfigs.Items数组，动态生成每个Resolver资源
  Fn::ForEach::ResolverGenerator:
    - ResolverConfig  # 循环变量名，代表数组中的单个元素
    - !FindInMap [ResolverConfigs, Items, []]  # 要遍历的数组
    - !Sub "GraphQl${ResolverConfig.FieldName}Resolver":
        Type: "AWS::AppSync::Resolver"
        # 所有Resolver都依赖同一个Schema，直接在这里声明
        DependsOn: !Ref GraphQlSchemaName
        Properties:
          ApiId: !Ref GraphQlApiId
          TypeName: !Ref ResolverConfig.TypeName
          FieldName: !Ref ResolverConfig.FieldName
          DataSourceName: !Ref DefaultDataSourceName
          RequestMappingTemplateS3Location: !Ref ResolverConfig.RequestTemplatePath
          # 如果响应模板有统一命名规则，可以用Sub动态生成
          ResponseMappingTemplateS3Location: !Sub "s3://your-template-bucket/resolvers/${ResolverConfig.FieldName}-response.vtl"

关键要点 #

• 必须添加Transform: AWS::LanguageExtensions，否则Fn::ForEach会报错
• 用Mappings或Parameters存储差异化配置数组，便于后续维护
• 通过!Sub动态生成唯一的资源名称，避免冲突
• 公共配置（比如ApiId、DataSourceName）可以统一引用，不用重复写

方法2：旧版CFN兼容方案（CloudFormation宏） #

如果你的环境不支持Fn::ForEach（比如使用较旧的CFN版本），可以通过自定义CloudFormation宏来实现遍历逻辑。不过这种方法需要先创建宏资源，复杂度稍高，适合必须兼容旧版本的场景。

核心思路 #

1. 创建一个Lambda函数，接收模板中的数组参数，生成对应的Resolver资源代码
2. 在CFN模板中声明AWS::CloudFormation::Macro，关联这个Lambda函数
3. 在模板中调用宏，传入Resolver配置数组，动态生成资源

不过说实话，现在大部分环境都支持Fn::ForEach了，除非特殊情况，不推荐用这种方法。

额外注意事项 #

• 资源名称唯一性：确保动态生成的资源名称符合CFN的命名规则，且不会重复
• DependsOn处理：如果所有Resolver都依赖同一个Schema，直接在循环模板中声明即可；如果有个别Resolver需要额外依赖，可以在数组中添加DependsOn字段，动态引用
• 模板验证：使用aws cloudformation validate-template命令验证模板，避免语法错误

内容的提问来源于stack exchange，提问作者honkskillet