terraform init 与 Provider

这一课你将能做到

1. 说清楚 terraform init 到底做了哪几件事，哪些产物该提交 Git
2. 正确声明 Terraform 和 provider 的版本约束，看懂锁文件
3. 掌握 provider 的多别名配置、升级方法和初始化常见报错的处理

为什么要学

init 是 Terraform 所有命令的「入场券」：不 init，plan 和 apply 都跑不了。它看着简单（一行命令），但背后负责下载 provider 插件、初始化后端、拉取子模块、建立模块索引。团队协作中版本对不齐、插件下不动、锁文件冲突，几乎是每个人第一周都会撞上的问题。这一课把 init 一次讲明白，以后遇到初始化问题不再靠玄学。

人话：init 像项目开工前的「领料 + 进场」——按清单把工具（provider）领齐、确认仓库门（backend）在哪、把外包小组（modules）联系上，之后才能开工。

先建立图像

init 的输入和产物：

输入：*.tf 中的 required_providers、backend、module 源
  │
  ├─ 下载 provider 插件 → .terraform/providers/
  ├─ 生成/校验依赖锁    → .terraform.lock.hjson
  ├─ 初始化 backend    → 本地目录 或 S3 等远程存储
  └─ 拉取子模块        → .terraform/modules/

Git 提交策略：

文件/目录	提交 Git？	原因
*.tf	是	配置本体
.terraform.lock.hjson	是	保证全员用同版本 provider
.terraform/	否	体积大、含平台相关二进制
terraform.tfstate	本地练习可留；团队用远程 backend	含敏感信息且需加锁
*.tfvars 含密钥时	否	密钥不进仓库

跟着做

步骤 1：写版本约束

新建 init-demo/versions.tf：

terraform {
  required_version = ">= 1.7.0"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"   # 允许 5.x，不允许 6.0
    }
    random = {
      source  = "hashicorp/random"
      version = ">= 3.5.0, < 4.0.0"
    }
  }
}

~> 5.0 是最常用的约束：允许 5.0–5.x 的任何补丁/小版本，6.0 不自动升（大版本可能有破坏性变更）。

步骤 2：配置 provider

新建 providers.tf：

provider "aws" {
  region = "ap-northeast-1"
}

此时还不需要真实 AWS 凭证即可 init——下载插件发生在凭证检查之前。

步骤 3：执行初始化

terraform init

输出中重点看三段：

Initializing the backend...
Initializing provider plugins...
- Finding hashicorp/aws versions matching "~> 5.0"...
- Installed hashicorp/aws v5.x.x ...
Terraform has been successfully initialized!