使用S3 Backend的Terraform如何发现所有工作区

Terraform S3 后端工作区查找逻辑 #

S3 类型的 Terraform 状态文件路径格式为 ${bucket_name}/${workspace_key_prefix}/${workspace_name}/${key}，其中 bucket、workspace_key_prefix、key 三个参数都是你提前写在 Terraform 后端配置里的固定值，不存在动态匹配的过程。

在新设备执行 terraform init 时，工作区查找流程如下：

• 首先读取本地的后端配置，拿到目标存储桶名、workspace_key_prefix 前缀、状态文件名 key 三个固定参数
• 直接调用 S3 的 ListObjectsV2 接口，仅扫描 ${bucket_name}/${workspace_key_prefix}/ 前缀下的一级子目录，不会遍历整个存储桶或者其他无关前缀路径
• 只要子目录下存在和你配置的 key 同名的状态文件，这个子目录名就会被识别为工作区名称
• 所有识别到的工作区会同步到本地 Terraform 缓存，后续执行 terraform workspace list 就能看到全部可用工作区

关于遍历问题的明确回答 #

不需要遍历所有相关存储位置。Terraform 的路径规则是完全固定的，只会扫描你指定的 workspace_key_prefix 前缀下的内容，扫描范围非常小，不会产生全桶遍历的额外开销。

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