使用kreuzwerker/docker 3.0.2实现后端容器等待PostgreSQL就绪

针对你遇到的后端容器不等待PostgreSQL就绪的问题，结合kreuzwerker/docker 3.0.2 Provider，有几种可靠的实现方式：

方案1：重写后端容器Entrypoint，在容器内等待PostgreSQL #

这种方式把等待逻辑放在后端容器内部，无需依赖Terraform运行环境的工具，适合跨场景使用。

首先给PostgreSQL容器配置健康检查（可选，但能更准确判断服务状态）：

resource "docker_container" "postgres" {
  provider = docker.database_server
  name     = "postgres"
  image    = docker_image.postgres.image_id
  env = [
    "POSTGRES_USER=postgres",
    "POSTGRES_PASSWORD=postgres",
    "POSTGRES_DB=postgres"
  ]
  ports {
    ip        = <some_ip>
    external  = 5432
    internal  = 5432
  }

  # 配置PostgreSQL健康检查，验证服务是否就绪
  healthcheck {
    test     = ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
    interval = "5s"
    timeout  = "5s"
    retries  = 10
  }
}

然后修改后端容器的启动命令，先等待PostgreSQL就绪再启动服务：

resource "docker_container" "backend" {
  provider = docker.backend_server
  name     = "backend"
  image    = docker_image.backend.image_id

  # 明确依赖PostgreSQL容器，确保它先被创建
  depends_on = [docker_container.postgres]

  # 重写Entrypoint，先执行等待逻辑
  entrypoint = [
    "/bin/sh",
    "-c",
    # 循环检查PostgreSQL连接，直到就绪
    "until pg_isready -h <some_ip> -p 5432 -U postgres; do echo 'Waiting for PostgreSQL...'; sleep 2; done; <你的后端启动命令>"
  ]

  # 如果后端镜像没有pg_isready工具，先安装（以Debian/Ubuntu镜像为例）
  # entrypoint = [
  #   "/bin/sh",
  #   "-c",
  #   "apt-get update && apt-get install -y postgresql-client && until pg_isready -h <some_ip> -p 5432 -U postgres; do echo 'Waiting for PostgreSQL...'; sleep 2; done; <你的后端启动命令>"
  # ]
}

方案2：用Local-Exec Provisioner在Terraform侧等待 #

这种方式依赖Terraform运行环境的工具，但无需修改容器镜像，逻辑更简洁。

方式A：用pg_isready直接检查数据库端口 #

resource "docker_container" "backend" {
  provider = docker.backend_server
  name     = "backend"
  image    = docker_image.backend.image_id

  depends_on = [docker_container.postgres]

  # 在创建后端容器前，本地执行脚本等待PostgreSQL就绪
  provisioner "local-exec" {
    command = <<EOT
      until pg_isready -h <some_ip> -p 5432 -U postgres; do
        echo "Waiting for PostgreSQL to be ready..."
        sleep 2
      done
    EOT
  }
}

注意：此方法要求运行Terraform的机器已安装postgresql-client包（包含pg_isready工具）。

方式B：检查PostgreSQL容器的健康状态 #

如果不想安装PostgreSQL客户端，可以直接通过Docker命令检查容器的健康状态：

# 新增空资源专门用于等待PostgreSQL健康状态
resource "null_resource" "wait_for_postgres" {
  depends_on = [docker_container.postgres]

  provisioner "local-exec" {
    command = <<EOT
      until docker inspect --format '{{.State.Health.Status}}' postgres | grep -q "healthy"; do
        echo "Waiting for PostgreSQL container to be healthy..."
        sleep 2
      done
    EOT
  }
}

resource "docker_container" "backend" {
  provider = docker.backend_server
  name     = "backend"
  image    = docker_image.backend.image_id

  # 依赖等待完成的空资源，确保PostgreSQL就绪后再启动后端
  depends_on = [null_resource.wait_for_postgres]
}

注意：此方法要求运行Terraform的机器已安装Docker CLI且有权限操作目标容器。

方案对比 #

• 容器内等待：无环境依赖，可移植性强，但需要修改后端容器启动逻辑，若镜像无pg_isready需额外安装工具。
• Terraform侧等待：无需修改容器，逻辑简单，但依赖运行环境的工具（Docker CLI或PostgreSQL客户端）。

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