基础设施即代码 / 知识点

Terraform CLI 与 HCL 速查手册

初始化与校验

CODE
terraform init [options]

在新项目、克隆仓库或后端与 Provider 配置变化后初始化工作目录,下载模块和 Provider;执行计划或应用变更前通常应先完成此步骤。

初始化工作目录

在首次运行 Terraform、克隆已有配置,或修改 Provider、模块来源和后端配置后使用 terraform init。它准备当前工作目录、初始化后端并获取配置依赖,使后续 terraform validate、terraform plan 和 terraform apply 可以正常工作。

基本语法

bash
terraform init [options]

最常用的初始化直接在根模块目录执行:

bash
terraform init

预期输出

text
Terraform has been successfully initialized!

成功时会出现以上完成信息;此前的模块、后端和 Provider 初始化明细会随当前配置而变化。

常用参数

参数 什么时候用
-upgrade 重新检查模块和 Provider 的允许版本范围,而不是优先沿用当前已选版本
-reconfigure 后端配置已改变,并明确要忽略此前保存的后端设置重新配置
-migrate-state 切换后端并需要尝试把现有状态迁移到新后端
-input=false CI 等非交互环境,不允许 Terraform 等待人工输入
-backend=false 明确需要跳过后端初始化的特殊流程;普通项目通常不使用

Provider 或模块版本约束改变后,需要重新初始化时可执行:

bash
terraform init -upgrade

预期输出

text
Terraform has been successfully initialized!

-upgrade 可能选择约束范围内更新的依赖版本,因此执行后应检查 .terraform.lock.hcl 的变化,再运行计划确认影响。

后端变更

后端地址、类型或关键配置变化后,普通 terraform init 可能要求明确选择重新配置还是迁移状态。两者目的不同:-reconfigure 接受新的后端配置但不执行已有状态迁移,-migrate-state 则用于尝试把状态复制到新的后端。

排障清单

初始化失败时优先检查 Provider Registry、模块源和后端是否能从当前网络访问,以及认证凭据是否有效。若错误明确提示配置发生变化并要求重新初始化,应根据实际变更重新执行 terraform init,不要通过删除状态文件绕过问题。

.terraform 保存当前工作目录的本地初始化数据,通常不应提交版本库;.terraform.lock.hcl 用于记录 Provider 版本选择,团队项目通常应提交并审查其变化。

计划与执行

HCL 编写与复用

状态与风险操作

目录与阅读设置

记录一个想法

Terraform CLI 与 HCL 速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通