Fargate任务未分配公网IP问题排查求助

算力阿峰

2026-8-23

问题描述

使用Step Functions运行Fargate任务，已在NetworkConfiguration的AwsvpcConfiguration中将AssignPublicIp设置为ENABLED，但查看任务时发现未分配公网IP。请问还需要进行哪些配置才能获取公网IP？

任务详情截图

对应的Step Functions任务配置片段：

"Stage XXX": {
      "Type": "Task",
      "ResultPath": null,
      "Resource": "arn:aws:states:::ecs:runTask.sync",
      "Parameters": {
        "LaunchType": "FARGATE",
        "Cluster": "<EXPORTED_NAME_FARGATE_CLUSTER_ARN>",
        "TaskDefinition": "<EXPORTED_NAME_FARGATE_TASK_ARN>",
        "NetworkConfiguration": {
          "AwsvpcConfiguration": {
            "Subnets": ["<SUBNET-0>", "<SUBNET-1>"],
            "AssignPublicIp": "ENABLED"
          }
        },
        "Overrides": {
          "ContainerOverrides": [
            {
              "Name": "spinarak-process-fargate-task-container",
              "Environment": [
                {
                  "Name": "REDO_INFER",
                  "Value.$": "$.RedoInfer"
                },
                {
                  "Name": "REDO_EDM",
                  "Value.$": "$.RedoEdm"
                }
              ]
            }
          ]
        }
      },
      "Retry": [
        {
          "ErrorEquals": ["States.ALL"],
          "IntervalSeconds": 3,
          "MaxAttempts": 0,
          "BackoffRate": 1.5
        }
      ],
      "Catch": [
        {
          "ErrorEquals": ["States.ALL"],
          "ResultPath": "$.taskerror",
          "Next": "Publish Failure"
        }
      ],
      "Next": "Stage YYY"
    },

解决建议

确认子网为公有子网：你指定的<SUBNET-0>和<SUBNET-1>必须是公有子网，即关联的路由表中存在0.0.0.0/0指向互联网网关（IGW）的路由条目。如果是私有子网，即使开启AssignPublicIp也无法分配公网IP。
检查任务定义网络模式：任务定义必须设置为awsvpc模式（这是Fargate任务的强制要求），只有该模式下AssignPublicIp参数才会生效。
验证子网MapPublicIpOnLaunch属性：虽然Fargate任务的AssignPublicIp优先级高于子网的MapPublicIpOnLaunch，但如果子网该属性设为false，建议确认是否存在配置冲突（通常Fargate配置会覆盖该子网属性）。
检查Step Functions执行角色权限：确保执行Step Functions的IAM角色拥有ecs:RunTask权限，且权限策略未限制AssignPublicIp参数的使用，避免因权限不足导致配置未生效。

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