Terraform部署Zookeeper到ECS EC2：挂载EFS遇端口2999不可用问题

一、端口2999不可用问题 #

1. 冲突原因 #

如果你的ECS集群是EC2类型，任务定义中硬指定host_port = 2999会导致：多任务调度到同一实例时端口占用冲突；单任务部署时，EC2实例上可能已有其他进程占用该端口。
如果是Fargate类型，Fargate不支持固定主机端口，强行指定会直接触发端口不可用错误。

2. 修复操作 #

• 修改Terraform任务定义的端口映射配置：

  port_mappings {
    container_port = 2999  # 保留容器端口不变
    host_port      = 0     # Fargate强制设为0；EC2类型建议设为0，通过服务发现/负载均衡访问
    protocol       = "tcp"
  }
  

• 若必须用固定主机端口（仅EC2集群适用）：
  • 登录EC2实例执行netstat -tulpn | grep 2999，停止占用进程或更换端口。
  • 在Terraform中给ECS服务配置placement_constraints，确保任务调度到未占用该端口的实例。

二、容器挂载卷失败问题（非EFS场景） #

1. 常见诱因 #

• 本地host卷的source_path在EC2实例上不存在，或权限不足导致容器无法读写。
• 任务执行角色缺少卷挂载相关权限（针对EBS等需IAM授权的卷类型）。
• 卷配置的readonly属性与容器读写需求冲突。

2. 修复操作 #

针对Host卷（EC2集群）：

• 在EC2实例的user_data中提前创建挂载目录并设置权限：

  resource "aws_launch_template" "ecs_instance" {
    # 其他配置...
    user_data = base64encode(<<-EOF
              #!/bin/bash
              mkdir -p /data/zookeeper
              chmod 777 /data/zookeeper
              chown ec2-user:ec2-user /data/zookeeper
              EOF
    )
  }
  

• 确保任务定义的卷配置正确关联该路径：

  task_definition {
    # 其他配置...
    volume {
      name      = "zookeeper-data"
      host_path = "/data/zookeeper"
    }
    container_definitions = jsonencode([
      {
        name = "zookeeper"
        # 其他容器配置...
        mountPoints = [
          {
            sourceVolume  = "zookeeper-data"
            containerPath = "/data"
            readOnly      = false
          }
        ]
      }
    ])
  }
  

针对EBS等其他卷类型：

• 确认任务执行角色拥有ec2:AttachVolume等必要权限。
• 检查容器内挂载路径的权限设置，确保容器运行用户有读写权限。

三、验证流程 #

1. 先单独修复端口配置，重新部署任务，确认端口错误消失。
2. 对比EFS的成功配置，逐一排查本地卷的路径、权限、IAM角色差异，逐步验证挂载功能。

内容的提问来源于stack exchange，提问作者A-Big-Moose