Github Action触发Fargate按需任务报错，寻求解决方案

你遇到的InvalidParameterValue: The filter 'null' is invalid错误，本质是因为Fargate任务必须绑定VPC网络配置（子网、安全组），不管是在任务定义里预设，还是运行时指定，否则AWS无法确定任务要在哪个网络环境中运行，就会抛出这个过滤器无效的错误。

方法一：更新任务定义，预设网络配置 #

这是一劳永逸的方式，后续触发任务时无需重复指定网络参数：

• 登录AWS ECS控制台，找到你的目标任务定义
• 点击「创建新版本」进入编辑页面，在网络配置区域：
  • 网络模式选择awsvpc（Fargate强制要求此模式）
  • 添加至少一个子网：选和你的DocumentDB处于同一VPC的子网，或者能访问DocumentDB的子网
  • 添加安全组：配置安全组规则，允许任务访问DocumentDB的默认端口27017，同时开放必要的出站流量（比如拉取镜像、访问AWS服务）
• 保存新版本任务定义，后续触发时指定这个新版本即可

方法二：在Github Action中动态指定网络参数 #

如果不想修改任务定义，或者需要根据环境动态切换网络配置，可以在触发任务的命令里直接传入网络参数：
在Github Action的AWS CLI执行步骤中，给ecs run-task命令加上--network-configuration参数，示例如下：

- name: 配置AWS凭证
  uses: aws-actions/configure-aws-credentials@v4
  with:
    aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
    aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    aws-region: us-east-1 # 替换成你的区域

- name: 触发Fargate一次性任务
  run: |
    aws ecs run-task \
      --cluster your-cluster-name \ # 替换成你的ECS集群名
      --task-definition your-task-def-name:latest \ # 替换成你的任务定义名+版本
      --launch-type FARGATE \
      --network-configuration "awsvpcConfiguration={subnets=[subnet-xxxxxx,subnet-yyyyyy],securityGroups=[sg-xxxxxx],assignPublicIp=DISABLED}" \
      --count 1

参数说明： #

• subnets：传入一个或多个子网ID，用逗号分隔
• securityGroups：传入任务使用的安全组ID
• assignPublicIp：如果任务需要访问公网（比如拉取私有镜像、调用外部API），设为ENABLED；否则用DISABLED（更安全）

额外注意事项 #

• 确保Github Action使用的IAM角色拥有ecs:RunTask权限，以及访问指定子网、安全组的权限，同时要有访问DocumentDB的权限
• 子网和安全组必须能和DocumentDB连通：要么同VPC，要么通过VPC对等连接/中转网关打通，安全组规则要允许ECS任务到DocumentDB的流量
• 这种一次性任务执行完成后会自动停止，完全符合你不需要创建Fargate服务的需求

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