Nomad同任务组Docker容器无法通信及HCL代码格式化问题求助

故障根因 #

• 同任务组内任务默认并行启动，Redis 服务未完成初始化、未监听 6379 端口时，应用容器已提前发起连接请求，触发连接拒绝错误
• 冗余的端口配置增加了网络链路复杂度：同任务组bridge网络模式下，所有容器共享同一个网络命名空间，可直接通过localhost:容器内部端口互相访问，无需声明组级端口、也无需调用NOMAD_ADDR_*环境变量，该变量返回的是宿主机IP+对外映射端口，反而会绕主机网络栈

修复方案 #

1. 调整任务启动依赖，在应用任务中添加depends_on配置，等待Redis任务正常启动后再启动应用
2. 移除不必要的Redis组级端口声明，同组内直接使用localhost:6379访问Redis

如使用的Nomad版本低于1.3不支持depends_on，可修改应用容器的启动命令，添加端口检测逻辑，例如sh -c "while ! nc -z localhost 6379; do sleep 1; done && 原有启动命令"，等待Redis端口可访问后再启动应用服务。

修复后完整配置 #

job "app-deployment" {
  datacenters = ["dc1"]

  group "app" {
    network {
      mode = "bridge"
      port "web-ui" { to = 5000 }
    }
    service {
      name = "web-ui"
      port = "web-ui"
      // check {
      //   type     = "http"
      //   path     = "/health"
      //   interval = "2s"
      //   timeout  = "2s"
      // }
    } 

    task "myapp" {
      driver = "docker"
      depends_on = ["redis"]
      config {
        image_pull_timeout = "10m"
        image = "https://docker.com"
        ports = ["web-ui"]
      }
      env {
        REDIS_URL="redis://localhost:6379"
        NODE_ENV="production"
      }
    }

    task "redis" {
      driver = "docker"
      config {
        image = "redis"
      }
    }
  }
}

解决方案 #

• 命令行工具：直接使用HashiCorp官方提供的hclfmt工具，执行hclfmt -w 配置文件路径即可自动格式化指定HCL文件
• VS Code适配：安装HashiCorp官方发布的HCL插件，开启保存自动格式化后，即可实现和JavaScript、YAML等同的自动格式化效果

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