如何使用同一Task Definition为ECS容器传入不同API_URL环境变量值？

当然可以用同一个Task Definition实现多环境的API_URL配置，下面是几种实用方案：

1. 启动任务/服务时直接覆盖环境变量 #

这是最简单的方式，无需修改原有Task Definition，在启动阶段传入新值覆盖默认配置：

• 用AWS CLI启动任务时，通过--overrides参数指定容器级环境变量：

  aws ecs run-task \
    --cluster your-cluster-name \
    --task-definition your-task-def-name \
    --overrides '{"containerOverrides":[{"name":"your-container-name","environment":[{"name":"API_URL","value":"http://staging.api.com"}]}]}'
  

• 如果是创建ECS服务，在服务配置的「容器覆盖」环节添加API_URL的新值即可。生产环境用默认值，staging环境在启动时指定新值，共用同一个Task Definition。

2. 借助SSM参数存储管理多环境变量 #

把不同环境的API_URL存储到AWS参数存储服务中，让Task Definition动态拉取对应环境的值：

1. 在SSM Parameter Store中创建两个参数：
   • 生产环境：/prod/API_URL，值为http://production.api.com
   • Staging环境：/staging/API_URL，值为http://staging.api.com
2. 修改Task Definition，将API_URL设置为从参数存储拉取，同时新增ENVIRONMENT变量区分环境：

   "containerDefinitions": [
     {
       "name": "your-container",
       "secrets": [
         {
           "name": "API_URL",
           "valueFrom": "arn:aws:ssm:你的区域:你的账号ID:parameter/${ENVIRONMENT}/API_URL"
         }
       ],
       "environment": [
         {
           "name": "ENVIRONMENT",
           "value": "prod" // 默认生产环境
         }
       ]
     }
   ]
   

3. 启动staging环境的任务/服务时，通过--overrides把ENVIRONMENT的值改为staging，容器会自动拉取对应环境的API_URL。注意要给ECS任务执行角色配置SSM参数的读取权限。

3. 使用S3存储环境变量文件 #

给每个环境单独创建.env文件并上传到S3，让Task Definition根据环境变量加载对应文件：

1. 在S3桶中创建prod.env和staging.env，分别写入API_URL=http://production.api.com和API_URL=http://staging.api.com
2. 修改Task Definition，配置从S3加载环境变量文件：

   "containerDefinitions": [
     {
       "name": "your-container",
       "environmentFiles": [
         {
           "value": "arn:aws:s3:::你的S3桶/${ENVIRONMENT}.env",
           "type": "s3"
         }
       ],
       "environment": [
         {
           "name": "ENVIRONMENT",
           "value": "prod" // 默认生产环境
         }
       ]
     }
   ]
   

3. 启动staging环境时，覆盖ENVIRONMENT变量为staging，容器会加载对应的.env文件。同样要给任务执行角色配置S3读取权限。

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