如何在AWS Fargate上启动Amazon ECS任务（容器）时传入参数

阿华AIGC实验室

2026-5-27

在AWS ECS Fargate中动态传递环境变量的方法

刚好我对ECS Fargate的动态参数配置熟得很，这就给你拆解怎么实现和本地Docker一样的灵活性！本质上就是通过ECS的任务覆盖（overrides）机制，在创建任务时动态注入不同的变量值，下面是具体的实现方式：

1. 直接通过任务创建时的Overrides动态传参

这是和你本地NAME=Peter docker run最接近的方式——在调用ECS API/CLI创建任务时，直接指定容器的环境变量值，覆盖任务定义里的默认设置。

示例1：AWS CLI命令

假设你的任务定义里已经配置了容器名称为static-site，现在要动态传入NAME=Peter：

aws ecs run-task \
  --cluster your-cluster-name \
  --task-definition your-static-site-task:1 \
  --launch-type FARGATE \
  --network-configuration "awsvpcConfiguration={subnets=[subnet-xxxxxx],securityGroups=[sg-xxxxxx],assignPublicIp=ENABLED}" \
  --overrides '{
    "containerOverrides": [
      {
        "name": "static-site",
        "environment": [
          {"name": "NAME", "value": "Peter"},
          {"name": "AUTHOR", "value": "Peter"}
        ],
        "command": ["sh", "-c", "echo Hello $NAME"]
      }
    ]
  }'

这里注意：如果要让容器里的echo命令解析环境变量，需要用sh -c包裹命令，否则环境变量不会被Shell展开。

示例2：Python Boto3编程实现

如果是用代码自动化创建任务，Boto3 SDK可以轻松实现动态传参：

import boto3

def run_fargate_task(name_value):
    ecs_client = boto3.client('ecs', region_name='us-east-1')
    
    response = ecs_client.run_task(
        cluster='your-cluster-name',
        taskDefinition='your-static-site-task:1',
        launchType='FARGATE',
        networkConfiguration={
            'awsvpcConfiguration': {
                'subnets': ['subnet-xxxxxx'],
                'securityGroups': ['sg-xxxxxx'],
                'assignPublicIp': 'ENABLED'
            }
        },
        overrides={
            'containerOverrides': [
                {
                    'name': 'static-site',
                    'environment': [
                        {'name': 'NAME', 'value': name_value},
                        {'name': 'AUTHOR', 'value': name_value}
                    ],
                    'command': ['sh', '-c', 'echo Hello $NAME']
                }
            ]
        }
    )
    return response

# 调用时传入不同的NAME值
run_fargate_task("Peter")
run_fargate_task("Alice")

2. 结合参数存储实现集中式动态配置

如果你的变量需要保密或者集中管理，可以用AWS SSM Parameter Store存储NAME的值，然后在任务定义里引用，编程时只需要修改参数值或者指定不同的参数名即可。

步骤：

先在SSM里创建参数：比如/ecs/static-site/NAME，值设为Peter
在任务定义中，将环境变量通过secrets字段引用SSM参数：

{
  "containerDefinitions": [
    {
      "name": "static-site",
      "secrets": [
        {"name": "NAME", "valueFrom": "arn:aws:ssm:us-east-1:123456789012:parameter/ecs/static-site/NAME"},
        {"name": "AUTHOR", "valueFrom": "arn:aws:ssm:us-east-1:123456789012:parameter/ecs/static-site/NAME"}
      ],
      "command": ["sh", "-c", "echo Hello $NAME"]
    }
  ]
}