如何利用Fn::ForEach读取配置文件生成CloudFormation路由？

核心思路 #

可以将dev.yaml中的路由集合传入Fn::ForEach函数，实现批量生成路由。核心是把配置文件中的集合作为模板输入数据（通过参数传递、映射定义等方式），再用Fn::ForEach遍历生成对应路由资源。以下是基于AWS CloudFormation的完整实现示例：

1. dev.yaml 路由配置文件 #

将所有dev环境的路由定义为数组格式：

RouteConfigs:
  - RouteName: "Dev-Route-01"
    DestinationCidrBlock: "10.0.1.0/24"
    Target: "igw-abc123"
    TargetType: "igw"
  - RouteName: "Dev-Route-02"
    DestinationCidrBlock: "10.0.2.0/24"
    Target: "nat-xyz789"
    TargetType: "nat"
  - RouteName: "Dev-Route-03"
    DestinationCidrBlock: "10.0.3.0/24"
    Target: "vpc-peering-def456"
    TargetType: "peering"

2. template.yaml 模板文件（结合Fn::ForEach） #

通过参数接收dev.yaml的路由集合，再遍历生成路由：

AWSTemplateFormatVersion: "2010-09-09"
Parameters:
  DevRouteConfigs:
    Type: List<Json>
    Description: 从dev.yaml导入的路由配置集合

Resources:
  DevRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: "vpc-123456" # 替换为你的VPC ID

  # 用Fn::ForEach遍历路由配置，批量生成路由资源
  Fn::ForEach::Routes:
    - RouteConfig
    - !Ref DevRouteConfigs
    - ${RouteConfig.RouteName}:
        Type: AWS::EC2::Route
        Properties:
          RouteTableId: !Ref DevRouteTable
          DestinationCidrBlock: !GetAtt [RouteConfig, DestinationCidrBlock]
          GatewayId: !If
            - !Equals [!GetAtt [RouteConfig, TargetType], "igw"]
            - !GetAtt [RouteConfig, Target]
            - !Ref AWS::NoValue
          NatGatewayId: !If
            - !Equals [!GetAtt [RouteConfig, TargetType], "nat"]
            - !GetAtt [RouteConfig, Target]
            - !Ref AWS::NoValue
          VpcPeeringConnectionId: !If
            - !Equals [!GetAtt [RouteConfig, TargetType], "peering"]
            - !GetAtt [RouteConfig, Target]
            - !Ref AWS::NoValue

3. 部署时传入dev.yaml配置 #

用AWS CLI部署，借助yq工具将YAML转成JSON格式传入参数：

aws cloudformation deploy \
  --template-file template.yaml \
  --stack-name dev-route-stack \
  --parameter-overrides DevRouteConfigs="$(cat dev.yaml | yq -r '.RouteConfigs | tojson')"

简化方案：直接在模板中嵌入环境配置 #

如果不需要单独的外部配置文件，可将dev路由集合定义在模板的映射中，直接遍历：

AWSTemplateFormatVersion: "2010-09-09"
Mappings:
  EnvRouteMaps:
    dev:
      Routes:
        - RouteName: "Dev-Route-01"
          DestinationCidrBlock: "10.0.1.0/24"
          Target: "igw-abc123"
          TargetType: "igw"
        - RouteName: "Dev-Route-02"
          DestinationCidrBlock: "10.0.2.0/24"
          Target: "nat-xyz789"
          TargetType: "nat"

Resources:
  DevRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: "vpc-123456"

  Fn::ForEach::Routes:
    - Route
    - !FindInMap [EnvRouteMaps, dev, Routes]
    - ${Route.RouteName}:
        Type: AWS::EC2::Route
        Properties:
          RouteTableId: !Ref DevRouteTable
          DestinationCidrBlock: !GetAtt [Route, DestinationCidrBlock]
          GatewayId: !If
            - !Equals [!GetAtt [Route, TargetType], "igw"]
            - !GetAtt [Route, Target]
            - !Ref AWS::NoValue
          NatGatewayId: !If
            - !Equals [!GetAtt [Route, TargetType], "nat"]
            - !GetAtt [Route, Target]
            - !Ref AWS::NoValue

关键注意事项 #

• Fn::ForEach仅支持遍历列表类型数据，所以配置中的路由必须定义为数组。
• 不同类型的路由目标（IGW/NAT/对等连接）需用Fn::If区分赋值，避免无效属性导致部署报错。
• 若使用SAM、CDK等部署工具，可直接加载外部YAML配置文件，无需手动转换格式。

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