AWS::Events::Rule如何向FARGATE类型TaskDefinition传参数作为环境变量

完全可以在不创建冗余TaskDefinition的前提下实现需求，只需通过EventBridge（原CloudWatch Events）规则Target的Input字段配置ECS任务运行时的参数覆盖即可，仅需维护一份通用的TaskDefinition。

核心原理 #

EventBridge触发ECS任务时，Input字段传入的JSON内容会作为RunTaskAPI的请求参数，你可以通过其中的Overrides配置项，在任务启动时动态覆盖TaskDefinition中指定的容器环境变量、资源配置等内容，无需修改原有TaskDefinition的定义。

具体配置示例 #

1. 公共TaskDefinition #

保留原有TaskDefinition即可，无需提前配置固定的环境变量，也可以配置默认值，运行时传入的变量会自动覆盖默认值。

2. 两个EventRule配置示例 #

两个规则复用同一个TaskDefinition，仅Input字段中的环境变量值不同：

# 第一个定时规则，传入变量value1
TaskScheduleRule1:
  Type: AWS::Events::Rule
  Properties:
    Description: "定时规则1"
    ScheduleExpression: "cron(0 12 1 2 ? *)"
    State: "ENABLED"
    Targets:
      - Arn:
          'Fn::ImportValue': !Sub "${ApplicationName}-cluster"
        Id: !Sub "${ApplicationName}-${EnvironmentName}-rule1-id"
        RoleArn: !GetAtt TaskSchedulerRole.Arn
        # 新增Input字段，配置运行时覆盖参数
        Input: !Sub |
          {
            "Overrides": {
              "ContainerOverrides": [
                {
                  "Name": "YOUR_CONTAINER_NAME", # 必须和TaskDefinition中定义的容器名称完全一致
                  "Environment": [
                    {
                      "Name": "VARIABLE",
                      "Value": "value1"
                    }
                  ]
                }
              ]
            }
          }
        EcsParameters:
          LaunchType: "FARGATE"
          TaskCount: 1
          TaskDefinitionArn: !Ref TaskDefinition
          # Fargate启动必须配置网络参数
          NetworkConfiguration:
            AwsVpcConfiguration:
              Subnets: ["subnet-xxx1", "subnet-xxx2"] # 替换为你的子网ID
              SecurityGroups: ["sg-xxx"] # 替换为你的安全组ID
              AssignPublicIp: "DISABLED"

# 第二个定时规则，传入变量value2
TaskScheduleRule2:
  Type: AWS::Events::Rule
  Properties:
    Description: "定时规则2"
    ScheduleExpression: "cron(0 13 1 2 ? *)"
    State: "ENABLED"
    Targets:
      - Arn:
          'Fn::ImportValue': !Sub "${ApplicationName}-cluster"
        Id: !Sub "${ApplicationName}-${EnvironmentName}-rule2-id"
        RoleArn: !GetAtt TaskSchedulerRole.Arn
        Input: !Sub |
          {
            "Overrides": {
              "ContainerOverrides": [
                {
                  "Name": "YOUR_CONTAINER_NAME",
                  "Environment": [
                    {
                      "Name": "VARIABLE",
                      "Value": "value2"
                    }
                  ]
                }
              ]
            }
          }
        EcsParameters:
          LaunchType: "FARGATE"
          TaskCount: 1
          TaskDefinitionArn: !Ref TaskDefinition
          NetworkConfiguration:
            AwsVpcConfiguration:
              Subnets: ["subnet-xxx1", "subnet-xxx2"]
              SecurityGroups: ["sg-xxx"]
              AssignPublicIp: "DISABLED"

注意事项 #

• ContainerOverrides下的Name字段必须和TaskDefinition中定义的容器名称完全匹配，否则环境变量覆盖不会生效。
• Fargate启动类型必须在EcsParameters中配置NetworkConfiguration参数，否则任务会启动失败。
• 调度使用的IAM角色（TaskSchedulerRole）需要包含ecs:RunTask的对应权限，无需额外新增特殊权限。

调整后调用链路如下，完全没有冗余配置：

Rule 1（传入value1） -> 公共TaskDefinition -> 启动应用带VARIABLE=value1
Rule 2（传入value2） -> 公共TaskDefinition -> 启动应用带VARIABLE=value2

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