AWS Elastic Beanstalk部署遇LimitExceeded: PORTS错误，求端口映射方案

问题原因 #

你遇到的LimitExceeded: PORTS错误，是因为AWS ECS任务定义对portMappings条目数量有默认限制（最多100个）。4000-4100共101个端口，逐个添加会超出该限制，导致部署失败。同时Elastic Beanstalk的Dockerrun.aws.json格式本身不支持直接配置端口范围映射，这也是你最初用docker-compose的端口范围配置无效的原因。

可行解决方案 #

方案1：使用主机网络模式（推荐） #

主机网络模式下，容器直接使用EC2实例的网络栈，无需配置端口映射，容器内监听的端口会直接暴露在EC2实例的对应端口上，完美适配端口范围需求。

操作步骤：

1. 修改Dockerrun.aws.json，添加networkMode: host并移除所有portMappings配置：

{  
  "AWSEBDockerrunVersion": 2,
  "networkMode": "host",
  "volumes": [],
  "containerDefinitions": [
    {
      // 保留容器的镜像、环境变量等配置
      // 删除portMappings字段
      ...
    }
  ]
}

2. 调整应用与安全组配置：
   • 如果原配置是将容器8080映射到主机80，可修改应用监听主机的80端口（需容器以root权限运行），或在EC2实例上配置iptables转发80到容器8080；
   • 配置Elastic Beanstalk环境的安全组，开放80端口以及4000-4100端口范围（TCP/UDP根据应用协议选择）。

方案2：拆分容器规避端口数量限制 #

如果无法使用主机网络模式，可以将应用拆分为多个容器，每个容器负责一部分端口范围，确保每个容器的portMappings条目数不超过100。

示例Dockerrun.aws.json配置：

{  
  "AWSEBDockerrunVersion": 2,
  "volumes": [],
  "containerDefinitions": [
    {
      "name": "main-app",
      "image": "your-main-image",
      "portMappings": [
        {
          "containerPort": 8080,
          "hostPort": 80
        }
      ],
      ...
    },
    {
      "name": "app-ports-4000-4050",
      "image": "your-app-image",
      "portMappings": [
        {"hostPort":4000,"containerPort":4000},
        {"hostPort":4001,"containerPort":4001},
        // ... 直到4050
      ],
      ...
    },
    {
      "name": "app-ports-4051-4100",
      "image": "your-app-image",
      "portMappings": [
        {"hostPort":4051,"containerPort":4051},
        {"hostPort":4052,"containerPort":4052},
        // ... 直到4100
      ],
      ...
    }
  ]
}

注意：需确保应用支持拆分运行，或每个容器实例仅监听分配给自己的端口范围。

方案3：动态端口映射（仅适用于HTTP/HTTPS服务） #

如果4000-4100端口均为HTTP/HTTPS服务，可使用动态端口映射，让ECS自动分配主机端口，再通过ELB监听规则转发流量。但此方案不适用于需要客户端指定固定端口的场景（如游戏、P2P服务）。

操作步骤：

1. 在Dockerrun.aws.json中，将所有需要动态分配的端口的hostPort设为0：

"portMappings": [
  {"containerPort":8080,"hostPort":80},
  {"containerPort":4000,"hostPort":0},
  {"containerPort":4001,"hostPort":0},
  // ... 所有端口设为动态分配
]

2. 配置ELB的多个监听端口（4000-4100），每个监听端口对应转发到目标组的对应容器端口。
   注意：ELB监听端口数量也有默认限制（最多50个），101个端口会超出该限制，此方案仅适用于端口数量较少的场景。

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