3. Terraform 安装与配置

在开始使用 Terraform 管理基础设施之前，必须完成安装、环境配置和基础命令熟悉。本章将引导你完成从下载到编写第一个 .tf 文件的完整流程，为后续构建 CI/CD 自助服务管道打下坚实基础。

3.1 下载与安装

Terraform 以单一二进制文件分发，支持主流操作系统。推荐从 HashiCorp 官方发布页面 获取最新稳定版本。

3.2 环境变量设置

Terraform 通过环境变量控制行为、配置 Provider 认证以及传递敏感信息。以下是最核心的变量：

• TF_VAR_<变量名>：在命令行或 CI/CD 中注入输入变量，避免硬编码。
• TF_LOG：设置日志级别（TRACE、DEBUG、INFO、WARN、ERROR），调试时常用 TF_LOG=DEBUG。
• TF_WORKSPACE：指定工作区名称，用于多环境隔离。
• TF_IN_AUTOMATION：设置为 true 时，Terraform 会调整输出格式，避免交互式提示，适合 CI/CD 管道。
• AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY：云 Provider 认证凭据（以 AWS 为例）。

3.3 CLI 基础命令

Terraform CLI 遵循 terraform <子命令> [选项] 结构。掌握以下命令即可完成日常操作：

3.4 Terraform 配置文件结构 (.tf 文件)

Terraform 使用 HashiCorp Configuration Language (HCL) 编写配置文件，文件扩展名为 .tf。一个典型的 Terraform 项目包含以下文件结构：

project-root/
├── main.tf          # 核心资源定义
├── variables.tf     # 输入变量声明
├── outputs.tf       # 输出值定义
├── terraform.tfvars # 变量赋值（敏感值应使用 .auto.tfvars 或环境变量）
├── providers.tf     # Provider 配置（云平台、版本）
└── versions.tf      # Terraform 和 Provider 版本约束

每个 .tf 文件由 块 (Block) 和 参数 (Argument) 组成。以下是各文件的核心内容示例：

providers.tf — 定义云平台连接

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

provider "aws" {
  region = var.aws_region
}

main.tf — 声明基础设施资源

resource "aws_instance" "web_server" {
  ami           = var.ami_id
  instance_type = var.instance_type

  tags = {
    Name        = "CI-CD-Demo-Server"
    Environment = var.environment
  }
}

variables.tf — 定义可复用输入

variable "aws_region" {
  description = "AWS 部署区域"
  type        = string
  default     = "us-east-1"
}

variable "instance_type" {
  description = "EC2 实例规格"
  type        = string
}

outputs.tf — 暴露资源属性

output "instance_public_ip" {
  description = "Web 服务器的公网 IP"
  value       = aws_instance.web_server.public_ip
}

3.5 验证安装与快速测试

完成安装后，执行以下命令验证环境：

# 检查版本
terraform --version

# 创建一个测试目录
mkdir terraform-test && cd terraform-test

# 创建最小配置文件
cat > main.tf <<EOF
terraform {
  required_version = ">= 1.5"
}

resource "null_resource" "hello" {
  provisioner "local-exec" {
    command = "echo 'Terraform 安装配置成功！'"
  }
}
EOF

# 初始化并应用
terraform init
terraform apply -auto-approve

3.6 常见安装问题与排查