ECS部署报错：指定awsvpc网络模式时需提供网络配置

在学习使用ECS结合GitHub Actions部署时，构建流水线执行aws ecs run-task命令遇到部署问题。执行的命令如下：

aws ecs run-task \
    --cluster ***-develop \
    --task-definition ***:2 \
    --launch-type FARGATE \
    --network-configuration "awsvpcConfiguration={subnets=[***],securityGroups=[***],assignPublicIp=ENABLED}" \
    --overrides '{"containerOverrides": [{"name": "***", "command": ["python3", "manage.py", "migrate"]]}]}

报错信息：

An error occurred (InvalidParameterException) when calling the RunTask operation: Network Configuration must be provided when networkMode 'awsvpc' is specified.

已尝试在仓库变量中用["subnet-XXX"]或subnet-xxx格式配置子网参数，仍无法解决，求其他解决办法。

• 修复命令语法错误
  你的--overrides参数末尾多了一个冗余的闭合括号，正确格式应为：

  --overrides '{"containerOverrides": [{"name": "***", "command": ["python3", "manage.py", "migrate"]}]}'
  

  多余的括号会导致AWS CLI解析命令时出错，无法正确识别前面的--network-configuration参数，进而抛出网络配置未提供的错误。

• 规范仓库变量传递格式
  确保GitHub Actions中传递子网、安全组变量时严格符合AWS要求：

  • 列表类型参数必须用英文方括号包裹，每个ID用双引号分隔，例如["subnet-xxxxxx", "subnet-yyyyyy"]
  • 通过环境变量传递时，避免值被转义或截断。示例GitHub Actions配置：

    env:
      SUBNETS: '["subnet-xxxxxx", "subnet-yyyyyy"]'
      SECURITY_GROUPS: '["sg-xxxxxx"]'
    

    命令中引用变量：

    --network-configuration "awsvpcConfiguration={subnets=$SUBNETS,securityGroups=$SECURITY_GROUPS,assignPublicIp=ENABLED}"
    

• 改用JSON格式传递完整配置
  避免字符串拼接的格式问题，使用--cli-input-json传递结构化配置，能大幅降低解析错误概率：

  aws ecs run-task \
    --cli-input-json '{
      "cluster": "***-develop",
      "taskDefinition": "***:2",
      "launchType": "FARGATE",
      "networkConfiguration": {
        "awsvpcConfiguration": {
          "subnets": ["subnet-xxxxxx"],
          "securityGroups": ["sg-xxxxxx"],
          "assignPublicIp": "ENABLED"
        }
      },
      "overrides": {
        "containerOverrides": [
          {
            "name": "***",
            "command": ["python3", "manage.py", "migrate"]
          }
        ]
      }
    }'
  

• 验证任务定义网络模式
  确认你的任务定义中networkMode已设置为awsvpc（FARGATE类型任务强制要求此模式），若任务定义配置不符，也会触发该错误。

• 升级AWS CLI版本
  旧版本AWS CLI对部分参数格式支持存在缺陷，执行以下命令升级到最新稳定版：

  pip install --upgrade awscli
  

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