如何在不销毁现有基础设施的情况下重命名GitLab托管的Terraform状态文件？

以下是可操作的步骤，确保状态文件重命名后现有基础设施不受影响：

• 备份当前状态文件：先在本地执行命令拉取并备份状态，防止操作失误丢失数据：

  terraform state pull > old-state-backup.tfstate
  

• 在GitLab后台重命名状态文件：

  1. 进入GitLab项目页面，导航到Infrastructure > Terraform states
  2. 找到目标状态文件，点击右侧的编辑图标（铅笔样式）
  3. 修改状态名称为新名称，保存更改

• 更新Terraform配置中的Backend设置：
  打开你的Terraform配置文件（通常是main.tf或单独的backend.tf），找到backend块，将name字段的值更新为新的状态文件名。
  示例（使用GitLab官方backend）：

  terraform {
    backend "gitlab" {
      project = "your-group/your-project"
      name    = "new-state-name" # 替换为新名称
    }
  }
  

  如果你使用的是http backend，需要同步更新url、lock_url、unlock_url中的状态文件名部分。

• 迁移状态到新名称：
  在本地或CI/CD流水线中执行初始化命令，带上-migrate-state参数，Terraform会自动将旧状态迁移到新的状态文件中：

  terraform init -migrate-state
  

  执行过程中会提示确认迁移，输入yes即可。

• 验证迁移结果：
  执行terraform plan命令，确认输出显示No changes. Your infrastructure matches the configuration.，说明状态已成功迁移，现有资源无需变更。

• 同步CI/CD配置：
  检查你的GitLab CI/CD流水线配置文件（.gitlab-ci.yml），如果有指定Terraform状态名称的变量或命令（比如TF_STATE_NAME），同步更新为新名称，确保后续流水线能正确调用新状态文件。

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