591_Terraform基础设施即代码¶

# macOS
brew install terraform                 # Homebrew 安装

# Ubuntu/Debian
wget -O - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform

# 验证安装
terraform version                      # 查看版本

# 设置 AWS 凭证（环境变量方式）
export AWS_ACCESS_KEY_ID="your-access-key"      # AWS 访问密钥
export AWS_SECRET_ACCESS_KEY="your-secret-key"  # AWS 秘密密钥
export AWS_DEFAULT_REGION="ap-southeast-1"      # 默认区域

# main.tf — 创建一台 AWS EC2 服务器

# 定义 Provider（使用哪个云平台）
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"        # AWS Provider 来源
      version = "~> 5.0"               # 版本约束
    }
  }
}

provider "aws" {
  region = "ap-southeast-1"            # 新加坡区域
}

# 定义 Resource（要创建的资源）
resource "aws_instance" "web" {        # 资源类型 + 资源名
  ami           = "ami-0c55b159cbfafe1f0"  # 系统镜像 ID
  instance_type = "t2.micro"           # 实例规格（免费套餐）

  tags = {
    Name = "my-web-server"             # 实例名称标签
  }
}

# 输出（显示创建后的信息）
output "public_ip" {
  value = aws_instance.web.public_ip   # 输出公网 IP
}

# 1. 初始化（下载 Provider 插件）
terraform init                         # 首次运行或添加新 Provider 时

# 2. 预览变更（看看要做什么）
terraform plan                         # 显示将要创建/修改/删除的资源
# 输出示例：Plan: 1 to add, 0 to change, 0 to destroy.

# 3. 应用变更（真正执行）
terraform apply                        # 创建资源（会再次确认）
terraform apply -auto-approve          # 跳过确认直接执行

# 4. 查看当前状态
terraform show                         # 查看已创建的资源详情

# 5. 销毁资源
terraform destroy                      # 删除所有已创建的资源

# variables.tf — 定义变量
variable "instance_type" {
  description = "EC2 实例规格"          # 变量描述
  type        = string                  # 变量类型
  default     = "t2.micro"             # 默认值
}

variable "instance_count" {
  description = "创建服务器数量"
  type        = number
  default     = 2
}

# main.tf — 使用变量
resource "aws_instance" "web" {
  count         = var.instance_count   # 引用变量
  ami           = "ami-xxx"
  instance_type = var.instance_type    # 引用变量

  tags = {
    Name = "web-${count.index + 1}"    # web-1, web-2
  }
}

# 通过命令行传入变量
terraform apply -var="instance_type=t2.small"

# 通过变量文件
# terraform.tfvars
instance_type  = "t2.small"
instance_count = 3

terraform apply -var-file="production.tfvars"  # 指定变量文件

# 使用社区模块创建 VPC
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"  # 来自 Terraform Registry
  version = "5.0.0"

  name = "my-vpc"
  cidr = "10.0.0.0/16"                # VPC 网段

  azs             = ["ap-southeast-1a", "ap-southeast-1b"]
  public_subnets  = ["10.0.1.0/24", "10.0.2.0/24"]
  private_subnets = ["10.0.3.0/24", "10.0.4.0/24"]

  enable_nat_gateway = true            # 启用 NAT 网关
}

# backend.tf — 把状态文件存到 S3（团队协作必须）
terraform {
  backend "s3" {
    bucket         = "my-terraform-state"   # S3 桶名
    key            = "prod/terraform.tfstate"  # 状态文件路径
    region         = "ap-southeast-1"
    dynamodb_table = "terraform-locks"      # DynamoDB 锁表（防并发）
    encrypt        = true                   # 加密存储
  }
}

# 查询最新的 Ubuntu AMI
data "aws_ami" "ubuntu" {
  most_recent = true                   # 最新的
  owners      = ["099720109477"]       # Canonical 官方

  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/ubuntu-*-22.04-amd64-server-*"]
  }
}

resource "aws_instance" "web" {
  ami = data.aws_ami.ubuntu.id         # 使用查询到的 AMI
  instance_type = "t2.micro"
}

# 使用 Workspace（工作空间）
terraform workspace new dev            # 创建 dev 环境
terraform workspace new prod           # 创建 prod 环境
terraform workspace select dev         # 切换到 dev

# 或使用不同的 tfvars 文件
terraform apply -var-file="envs/dev.tfvars"
terraform apply -var-file="envs/prod.tfvars"

# === 核心命令 ===
terraform init                  # 初始化
terraform plan                  # 预览变更
terraform apply                 # 应用变更
terraform destroy               # 销毁资源
terraform show                  # 查看状态
terraform output                # 查看输出
terraform fmt                   # 格式化代码
terraform validate              # 验证配置
terraform import TYPE.NAME ID   # 导入现有资源
terraform state list            # 列出状态中的资源

# === 文件命名惯例 ===
# main.tf        → 主配置
# variables.tf   → 变量定义
# outputs.tf     → 输出定义
# providers.tf   → Provider 配置
# backend.tf     → 远程状态配置
# terraform.tfvars → 变量值