如何在Terraform GCS后端中指定状态文件名称

首先明确GCS后端的参数逻辑：prefix参数的作用仅为指定状态文件在存储桶内的存放目录前缀，不会被解析为状态文件名。你当前配置把prefix设为base/terraform.state，后端会直接将该路径作为目录处理，默认根工作区的状态文件以后端硬编码的固定名称default.state存入该目录，这就是你看到当前目录结构的原因。

官方GCS后端没有提供直接修改根工作区状态文件名的可配置项，要实现自定义状态命名/路径的需求，可以按以下两种场景处理：

• 如果你需要在同一个存储桶内区分多套独立环境的状态，直接使用Terraform工作区即可满足自定义文件名的需求：执行terraform workspace new <你自定义的状态名>创建非默认工作区后，后端会自动在prefix指定的目录下生成和工作区同名的.state文件。比如执行terraform workspace new prod，对应状态文件的对象键就是<prefix配置值>/prod.state，文件名完全和你自定义的名称一致。
• 如果你只是想调整状态文件的存放路径达到预期的命名展示效果，直接调整prefix的层级即可：比如你希望状态路径的前缀包含terraform.state标识，保留当前prefix = "base/terraform.state"的配置就行——GCS本身是扁平化的对象存储，不存在真实的目录概念，最终存储的对象键为base/terraform.state/default.state完全不影响状态的正常读写。

不要手动修改存储桶内已生成的状态文件名，Terraform后端按照固定命名规则查找状态文件，手动改名会导致Terraform无法识别已有状态，触发全量资源重建。

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