+86 189 8218 1436 周一至五 10:00-22:00

terraform gcp 教学入门

TL;DR:讲清 Terraform 如何在 GCP 创建 VM、网络与权限,带小白完成初始化、计划、应用和状态管理。

它是什么

先记一句话:Terraform 是「基础设施即代码」(IaC)工具。以前在 GCP 上开 VM、建 VPC、划子网、配防火墙、给同事加 IAM 权限,得进网页控制台点十几下,点完还记不清自己改过啥。现在把这些全写进 .tf 文件,用 HCL 描述「我最终想要长什么样」,再让工具替你去建。为什么要这么绕?因为写下来的东西能进 Git、能发给同事评审、能回滚,比口头一句「我调了下防火墙」靠谱太多。

先确认装没装,下面这行直接复制:

terraform version

提示「找不到命令」就先装:macOS 用 brew install terraform,Windows 用 choco install terraform,装完再跑一次。坑 1:别在空目录里急着 init,先有个 .tf 文件再初始化,不然下一步会发懵。建个最小例子,记得把项目 ID 换成你自己的(照抄会报权限错):

mkdir tf-demo && cd tf-demo
cat > main.tf <<'EOF'
terraform {
  required_providers {
    google = { source = "hashicorp/google", version = "~> 5.0" }
  }
}
provider "google" {
  project = "你的-gcp-项目-ID"
  region  = "asia-east1"
}
resource "google_compute_network" "vpc" {
  name = "demo-vpc"
}
resource "google_compute_subnetwork" "subnet" {
  name          = "demo-subnet"
  ip_cidr_range = "10.0.1.0/24"
  region        = "asia-east1"
  network       = google_compute_network.vpc.id
}
EOF
terraform init
terraform plan

这里有两个关键角色。GCP Provider 是个「翻译官」:它把 HCL 里的 VPC、子网、google_compute_instance(VM)、防火墙规则和 IAM 绑定,统统翻译成真正的 GCP API 调用发出去;terraform init 干的就是把它下载到本地 .terraform/。坑 2:换电脑、删了这目录、或改了版本号,都要重新 init,否则会报 provider not found。

另一个是 State 文件(默认 terraform.tfstate),它是一张对照表,记录「代码里这一行」对应「云上那个真实资源 ID」。没有它,Terraform 下次就不知道该改谁、该删谁,很容易重复建出一堆东西。看一眼它记了啥:

terraform state list

坑 3:别手改、别手删,更别提交到公开 Git 仓库(里面可能带敏感信息);团队协作请改用 GCS 存远端 state。

最后把最容易搞混的三点说清楚:

  • 它不是 Linux 命令,只是个独立小程序,Windows、macOS 上照样跑,跟 ls、grep 不是一家。
  • 它也不是 Cloud Console 的替代品,看账单、查日志、临时排障还是用控制台更顺手。
  • 它真正做的,是把云资源创建流程变成可评审的代码:先 plan 看变更清单,确认没问题再 apply,谁改了啥全留在提交记录里。

现在先别 apply。如果 plan 报凭证错误,跑一次 gcloud auth application-default login 再回来看预览——坑 4:这不是 Terraform 坏了,只是它还没「登录」而已。

解决什么问题

这篇 terraform gcp 教學 先解决一个问题:云上资源一多,怎么把“建了什么、为什么改、谁来改、怎么删”讲清楚。

手工在 GCP 控制台创建 VM、网络、防火墙和服务账号,很容易漏配:子网选错、防火墙没开或开太大、服务账号权限给多给少。换人、换项目重做难复制;事后靠截图和日志,也难解释谁改了什么、为什么改。

先做个不花钱的练习:建目录、放进 Git、检查 Terraform 是否可用。

mkdir -p terraform-gcp-demo
cd terraform-gcp-demo
git init
terraform version

为什么这么做?Terraform 先把“我要什么”写成 .tf 文件,再对照 GCP 现状执行。常见坑:最后一行提示找不到命令还继续跑;这时先安装 Terraform,别急着连云。

基础设施写进 Git 后,改动能做版本管理、回滚,提交前能代码评审,预览变更能看 diff,常用的网络、VM、权限组合还能做成模块复用。开发、测试、生产从同一份配置长出来,减少环境漂移:不是“谁记得就照着点”,而是“文件怎么写就怎么建”。

多人协作时,写好 .tf 并确认 GCP 项目没选错后,在配置目录一行一行执行;第一行只是准备插件:

terraform init
terraform plan
terraform apply
terraform plan -destroy
terraform destroy

terraform plan 先展示差异,terraform apply 才执行变更;测试完用 terraform plan -destroy 预览删除范围,再 terraform destroy 清理,比逐个找资源可控。坑:每行都能单独复制执行,第一次别一口气全贴;apply 和 destroy 会真的改云端、可能产生费用;别加自动确认,也别把 terraform.tfstate 和密钥 JSON 提交到 Git。

怎么上手

第一次跟着 terraform gcp 教學 动手,别急着写代码,先把「地基」打好。你需要一个 GCP 项目,本地装好 gcloud 和 terraform,再开启 Compute Engine API——不启 API 是最常见的报错,Terraform 会直接回你一句「服务未启用」。

# ① 没装工具先装(Mac 用这行;Windows 去官网下安装包,装完务必重开终端)
brew install google-cloud-sdk terraform

# ② 只改这一行为你自己的项目 ID,后面整段直接复制跑
export PROJECT_ID="YOUR_PROJECT_ID"

gcloud auth login
gcloud config set project $PROJECT_ID
gcloud services enable compute.googleapis.com

# ③ 建服务账号,只给计算权限(最小权限原则)
gcloud iam service-accounts create tf-demo --display-name="Terraform Demo"
gcloud projects add-iam-policy-binding $PROJECT_ID 
  --member="serviceAccount:tf-demo@${PROJECT_ID}.iam.gserviceaccount.com" 
  --role="roles/compute.admin"
gcloud iam service-accounts keys create ~/tf-key.json 
  --iam-account="tf-demo@${PROJECT_ID}.iam.gserviceaccount.com"

export GOOGLE_APPLICATION_CREDENTIALS=~/tf-key.json

为什么不用自己账号? 个人号权限太大,脚本手滑可能删光项目;单独建账号只给 compute.admin,翻车也只影响虚拟机。小白坑:那个 .json 密钥等于密码,千万别传 GitHub;export 只在当前窗口有效,重开终端要再敲一次。

接着新建空文件夹,把下面内容存成 main.tf(记得把 YOUR_PROJECT_ID 也换成刚才那个)。项目 ID 和区域抽成变量,以后换区只改一行:

variable "project_id" { default = "YOUR_PROJECT_ID" }
variable "region"     { default = "asia-east1" }

provider "google" {
  project = var.project_id
  region  = var.region
}

resource "google_compute_network" "vpc" {
  name                    = "tf-demo-vpc"
  auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "subnet" {
  name          = "tf-demo-subnet"
  ip_cidr_range = "10.0.1.0/24"
  region        = var.region
  network       = google_compute_network.vpc.id
}

resource "google_compute_firewall" "ssh" {
  name    = "tf-demo-allow-ssh"
  network = google_compute_network.vpc.name
  allow {
    protocol = "tcp"
    ports    = ["22"]
  }
  source_ranges = ["0.0.0.0/0"]
  target_tags   = ["ssh"]
}

resource "google_compute_instance" "vm" {
  name         = "tf-demo-vm"
  machine_type = "e2-micro"
  zone         = "${var.region}-a"
  tags         = ["ssh"]

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    subnetwork = google_compute_subnetwork.subnet.id
    access_config {}
  }
}

关掉 auto_create_subnetworks 是为了不跟默认网络抢网段;防火墙靠 target_tags 精准绑到这台 VM,比全局乱放行安全。access_config {} 则给个临时公网 IP,等下好验证。

在这个文件夹里,严格按顺序敲:

  1. terraform init:下载 GCP 插件,相当于「装驱动」,换目录都得重跑。
  2. terraform plan:只预演、不花钱!盯一眼结尾是不是 Plan: 4 to add,别冒出意外删除。
  3. terraform apply:输 yes 真建。去控制台看到 VM 亮绿灯就稳了。
terraform init
terraform plan
terraform apply

最最重要:测完一定清掉,不然免费额度烧完下月收账单!一条命令全删:

terraform destroy

再输一次 yes。Terraform 会自动按依赖倒序删「VM → 防火墙 → 子网 → VPC」,不用去控制台一个个点,这就是它最爽的地方。

与替代方案对比

做 terraform gcp 教學 时,先别急着背工具名。Cloud Console 适合临时查看、救火和单次操作;gcloud 脚本适合查项目、加标签这类简单重复任务;Terraform 更适合长期维护可复制环境,例如开发、测试、正式都要同一套网络、权限和 bucket。它把“最后要长什么样”写进文件,换项目、换同事也能按同一份配置重建。

先在 Cloud Shell 复制这行看当前项目,不会改资源;若输出为空,先在 Console 选好项目,这是常见坑:

gcloud config list project --format='value(core.project)'

另一个坑是:Console 点完过两周没人记得步骤;gcloud 脚本变多后,删除顺序、资源是否存在、失败重试都要自己写判断,维护成本会越来越高。

再用不花钱的小实验感受“先声明、再预览”,不会开 VM、不会扣费:

mkdir -p /tmp/tf-compare
cd /tmp/tf-compare
printf '%sn' 'output "message" {' '  value = "terraform gcp 教學:先理解 state,再创建资源"' '}' > main.tf
terraform init
terraform validate
terraform plan

为什么要跑?Terraform 的价值不是替你敲命令,而是执行前先看变更计划。注意,真正执行变更才会改云资源;看到加号也先确认项目、区域和费用。

和其他工具比:

  • Deployment Manager:GCP 原生、入门顺,但主要服务 GCP,模板和跨云资料较少。
  • Config Connector:适合已用 Kubernetes 的团队,用 YAML 管 GCP;没懂 K8s 会多一层负担。
  • Pulumi:可用 Python、TypeScript 写,灵活;但模块、规范和资料通常 Terraform 更成熟。
  • Ansible:偏按步骤配置机器,装软件很强;长期描述云资源和依赖不是强项。

因此,与 Deployment Manager、Config Connector、Pulumi、Ansible 相比,Terraform 偏声明式编排:写目标状态,Provider 调 GCP API,State 记住现实资源;跨 AWS、Azure、GCP 时,工作流和模块生态更成熟。

代价是得懂 HCL、Provider、State 和 GCP 权限模型。State(状态文件)像账本,放本机、提交 Git 或多人同时执行,容易误删、重复创建、泄露信息,带来协作风险。团队请用 GCS 远端 State 并加锁,Service Account 给最小权限,别图省事绑 Owner。

最佳实践

常见问题(FAQ)

没有 Linux 基础能学 terraform gcp 教学吗?

可以,先懂项目、VM、网络和权限,再照着示例反复练习。

terraform apply 会不会立刻产生费用?

会,创建 VM、磁盘、公网 IP 后通常开始计费,练习后及时执行 terraform destroy。

State 文件可以删掉吗?

不要直接删,它记录资源映射;应放在 Cloud Storage 并开启版本控制。

Terraform 和 gcloud 只能选一个吗?

不是,gcloud 适合查询和临时操作,Terraform 适合长期管理资源。

已有 GCP 资源能接管吗?

可以,用 terraform import 或导入块逐步纳入管理,先备份配置。

不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。

查看代维服务 →

发表评论