4. DynamoDB 锁实现：DynamoDB 表设计、锁记录结构、TTL 与自动清理

Terraform 使用 Amazon DynamoDB 作为分布式锁的后端存储，通过其强一致性读取与条件写入能力实现跨进程、跨机器的状态锁协调。本章深入剖析 DynamoDB 锁表的表结构设计、锁记录字段定义、租约机制以及基于 TTL 的自动清理策略。

4.1 DynamoDB 锁表设计

锁表是 Terraform 后端配置中 dynamodb_table 参数指定的核心资源。表设计遵循“单表、主键驱动、最小化写入”原则，确保高并发下的性能与可靠性。

4.2 锁记录结构

每条锁记录是一个 DynamoDB 项目（Item），包含以下字段：

Info 字段的 JSON 结构示例：

{
  "ID": "4a7b8c9d-1234-5678-90ab-cdef12345678",
  "Operation": "apply",
  "Info": "Terraform v1.7.0 on linux_amd64",
  "Who": "jenkins@build-01",
  "Version": "1.7.0",
  "Created": "2024-04-05T10:30:00Z",
  "Path": "terraform.tfstate"
}

4.3 锁获取与释放流程

下图展示了 Terraform 客户端与 DynamoDB 锁表之间的交互流程：

4.4 TTL 与自动清理机制

DynamoDB 的 TTL（Time to Live）功能允许表自动删除过期数据，无需额外运维成本。Terraform 锁表利用此特性实现“租约超时自动释放”。

4.4.1 TTL 工作原理

1. 启用 TTL：在 DynamoDB 表上启用 TTL，指定属性名为 TTL（区分大小写）。
2. 写入 TTL 值：每次锁记录写入时，计算当前时间 + 租约时长（默认 60 秒）的 Unix 时间戳，存入 TTL 属性。
3. 后台删除：DynamoDB 后台进程扫描表，删除 TTL 属性值小于当前时间的项目。删除操作在 48 小时内完成，但通常几分钟内生效。
4. 客户端感知：Terraform 客户端在锁冲突时重试，若原持有者已超时，TTL 删除后新客户端可成功获取锁。

4.4.2 租约时长配置

4.5 锁表创建示例

以下 Terraform 配置创建支持锁机制的 DynamoDB 表：

resource "aws_dynamodb_table" "terraform_lock" {
  name         = "terraform-lock"
  billing_mode = "PAY_PER_REQUEST"
  hash_key     = "LockID"

  attribute {
    name = "LockID"
    type = "S"
  }

  ttl {
    attribute_name = "TTL"
    enabled        = true
  }

  point_in_time_recovery {
    enabled = true
  }

  tags = {
    Name        = "Terraform State Lock Table"
    Environment = "Production"
  }
}

4.6 锁记录生命周期状态图

下图展示了锁记录从创建到删除的完整生命周期：

4.7 常见问题与避坑指南