使用Terraform在Docker镜像更新前备份关联的Docker卷

Terraform的Docker Provider确实没有内置容器启动前执行自定义操作的钩子，但可以通过以下几种方式实现更新前备份卷的需求：

1. 使用local_exec Provisioner直接执行备份命令 #

在定义容器资源之前，添加null_resource配合local_exec，调用Docker命令完成卷备份。通过触发器监听镜像变化，确保每次更新容器前自动备份：

resource "null_resource" "volume_backup" {
  triggers = {
    # 容器镜像更新时触发备份
    container_image = var.container_image
  }

  provisioner "local-exec" {
    command = <<EOT
      # 用时间戳生成唯一备份卷名
      BACKUP_VOLUME_NAME="${var.target_volume}-backup-$(date +%Y%m%d%H%M%S)"
      # 创建备份卷
      docker volume create $BACKUP_VOLUME_NAME
      # 同步原卷内容到备份卷
      docker run --rm \
        -v ${var.target_volume}:/source \
        -v $BACKUP_VOLUME_NAME:/target \
        busybox:latest cp -a /source/. /target/
      echo "Backup completed: $BACKUP_VOLUME_NAME"
    EOT
  }
}

# 容器资源依赖备份完成后再更新
resource "docker_container" "app" {
  name  = "my-app"
  image = var.container_image
  volumes {
    volume_name    = var.target_volume
    container_path = "/app/data"
  }

  depends_on = [null_resource.volume_backup]
}

如果是有状态应用，建议在备份前先停止容器（在command中添加docker stop my-app || true），避免数据不一致。

2. 封装备份逻辑为可复用模块 #

把备份逻辑抽成Terraform模块，方便在多个项目中复用：

# modules/volume-backup/main.tf
variable "source_volume" {
  type        = string
  description = "需要备份的源卷名称"
}

variable "image_tag" {
  type        = string
  description =  "触发备份的镜像版本标记"
}

resource "null_resource" "backup" {
  triggers = {
    source_volume = var.source_volume
    image_tag     = var.image_tag
  }

  provisioner "local-exec" {
    command = <<EOT
      BACKUP_VOLUME_NAME="${var.source_volume}-backup-$(date +%Y%m%d%H%M%S)"
      docker volume create $BACKUP_VOLUME_NAME
      docker run --rm -v ${var.source_volume}:/source -v $BACKUP_VOLUME_NAME:/target busybox cp -a /source/. /target/
    EOT
  }
}

output "backup_volume_name" {
  type        = string
  value       = "${var.source_volume}-backup-$(date +%Y%m%d%H%M%S)"
  description = "生成的备份卷名称"
}

调用模块示例：

module "app_volume_backup" {
  source        = "./modules/volume-backup"
  source_volume = "app-data"
  image_tag     = var.container_image_tag
}

resource "docker_container" "app" {
  # ... 容器配置 ...
  depends_on = [module.app_volume_backup]
}

3. 回滚操作的实现 #

当需要回滚时，只需两步：

• 修改容器的image参数为旧版本
• 恢复备份卷到原卷（或直接挂载备份卷）：

# 恢复备份到原卷
docker run --rm -v app-data:/target -v app-data-backup-20240520143000:/source busybox cp -a /source/. /target/

之后重新应用Terraform配置即可完成回滚。

注意事项 #

• 备份时若容器正在运行，可能出现数据不一致，有状态应用建议先停容器再备份
• 定期清理旧备份卷，避免占用过多磁盘空间
• 集群环境（如Swarm）的卷备份逻辑类似，可适配集群命令调整

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