如何在Terraform中结合DigitalOcean Droplet使用Docker Provider

错误原因 #

Terraform的执行流程是先初始化所有Provider，再创建/管理资源。当你在Docker Provider块中直接引用digitalocean_droplet.dev.ipv4_address时，Droplet还未创建，该变量的值为空字符串，导致Docker Provider无法解析有效的host地址，从而抛出`unable to parse docker host ```错误。

解决方案 #

方案一：分两次执行Terraform（快速解决） #

先单独创建Droplet，再执行完整部署：

1. 第一次执行，仅创建Droplet：

terraform apply -target=digitalocean_droplet.dev

2. 第二次执行，完成Docker应用部署：

terraform apply

此时Droplet已存在，IP值已被Terraform捕获，Docker Provider能正常解析host地址。

方案二：使用Remote-Exec Provisioner直接部署（无需Docker Provider） #

在Droplet资源中添加remote-execProvisioner，通过SSH直接在Droplet上安装Docker并部署应用，跳过Docker Provider的配置问题：

resource "digitalocean_droplet" "dev" {
  # 你的Droplet基础配置（镜像、规格、区域等）
  image  = "ubuntu-22-04-x64"
  name   = "dev-droplet"
  region = "nyc3"
  size   = "s-1vcpu-1gb"
  ssh_keys = [
    # 替换为你的SSH密钥ID或指纹
    data.digitalocean_ssh_key.my_key.id
  ]

  provisioner "remote-exec" {
    inline = [
      # 安装Docker
      "sudo apt-get update -y",
      "sudo apt-get install -y docker.io",
      "sudo systemctl enable --now docker",
      # 给devops用户添加Docker权限（避免每次sudo）
      "sudo usermod -aG docker devops",
      # 部署你的应用（替换为实际的Docker命令）
      "docker run -d -p 80:80 nginx:latest"
    ]
  }

  connection {
    type        = "ssh"
    user        = "devops"
    private_key = file("~/.ssh/id_rsa") # 替换为你的私钥路径
    host        = self.ipv4_address
  }
}

方案三：使用Terraform Remote State拆分配置（适合复杂场景） #

将Droplet创建和Docker部署拆分为两个独立的Terraform配置，通过Remote State共享IP：

1. 配置1：创建Droplet并导出IP到Remote State

# droplet.tf
resource "digitalocean_droplet" "dev" {
  # Droplet配置...
}

output "droplet_ip" {
  value = digitalocean_droplet.dev.ipv4_address
}

# 配置Remote State（以DigitalOcean Spaces为例）
terraform {
  backend "s3" {
    endpoint = "nyc3.digitaloceanspaces.com"
    bucket   = "tf-state-bucket"
    key      = "droplet/state.tfstate"
    region   = "nyc3"
    access_key = "DO_SPACES_ACCESS_KEY"
    secret_key = "DO_SPACES_SECRET_KEY"
    skip_region_validation = true
    skip_credentials_validation = true
  }
}

2. 配置2：读取Remote State并配置Docker Provider

# docker.tf
data "terraform_remote_state" "droplet" {
  backend = "s3"
  config = {
    endpoint = "nyc3.digitaloceanspaces.com"
    bucket   = "tf-state-bucket"
    key      = "droplet/state.tfstate"
    region   = "nyc3"
    access_key = "DO_SPACES_ACCESS_KEY"
    secret_key = "DO_SPACES_SECRET_KEY"
    skip_region_validation = true
    skip_credentials_validation = true
  }
}

provider "docker" {
  host = "ssh://devops@${data.terraform_remote_state.droplet.outputs.droplet_ip}"
}

# 你的Docker资源配置（比如docker_container、docker_image等）
resource "docker_container" "app" {
  image = "nginx:latest"
  name  = "my-app"
  ports {
    internal = 80
    external = 80
  }
}

分别执行两个配置的terraform apply即可完成部署。

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