Pulumi 简介与快速入门

IaC 的发展与 HCL 的局限性

基础设施即代码（IaC）简史

基础设施即代码（Infrastructure as Code）是将云基础设施的配置用代码文件描述，并通过代码管理其生命周期的实践。IaC 让基础设施像应用代码一样可版本化、可审查、可自动化部署。

Terraform 在 2014 年普及了 IaC 理念，引入了 HCL（HashiCorp Configuration Language）——一种专门为基础设施配置设计的声明式语言。HCL 语法简洁，入门容易，极大降低了 IaC 的学习门槛，迅速成为事实标准。

HCL 在复杂场景下的痛点

然而随着基础设施规模增长，HCL 的局限性开始显现：

Pulumi 的核心理念

用真实编程语言写 IaC

Pulumi 的核心思路是：不发明新语言，用你已经会的语言写基础设施。Pulumi 程序就是一个普通的 Python/TypeScript/Go/C# 程序，只是它调用了 Pulumi SDK 提供的资源构造器，而不是业务逻辑。

# 创建多个 S3 Bucket（HCL）
resource "aws_s3_bucket" "buckets" {
  for_each = toset([
    "logs", "assets", "backups"
  ])
  bucket = "my-${each.key}"
}

# 创建多个 S3 Bucket（Python）
import pulumi_aws as aws

names = ["logs", "assets", "backups"]
buckets = [
    aws.s3.Bucket(f"my-{name}")
    for name in names
]

Pulumi 与同类工具对比

安装 Pulumi CLI 与语言 SDK

安装 Pulumi CLI

# macOS（Homebrew）
brew install pulumi/tap/pulumi

# Linux / macOS（脚本安装）
curl -fsSL https://get.pulumi.com | sh

# Windows（PowerShell）
winget install pulumi

# 验证安装
pulumi version
# v3.x.x

安装语言运行时与 SDK

# ── Python 环境 ──
# 需要 Python 3.8+
python3 --version

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# Windows: venv\Scripts\activate

# 安装 Pulumi AWS SDK
pip install pulumi pulumi-aws

# ── TypeScript 环境 ──
# 需要 Node.js 18+
node --version

# 安装 Pulumi TypeScript SDK（项目初始化时自动安装）
npm install @pulumi/pulumi @pulumi/aws

配置 Pulumi Cloud（免费状态托管）

# 登录 Pulumi Cloud（免费，托管状态）
pulumi login
# 会打开浏览器访问 app.pulumi.com 完成授权

# 也可以使用本地文件系统（不推荐生产）
pulumi login --local

# 使用自托管 S3 后端
pulumi login s3://my-pulumi-state-bucket

# 查看当前登录状态
pulumi whoami

配置云凭证

# ── AWS 凭证配置 ──
# 方式1：使用 AWS CLI 配置
aws configure
# AWS Access Key ID: AKIAIOSFODNN7EXAMPLE
# AWS Secret Access Key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
# Default region name: us-east-1

# 方式2：环境变量（CI/CD 推荐）
export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/..."
export AWS_REGION="us-east-1"

# ── GCP 凭证配置 ──
gcloud auth application-default login

# ── Azure 凭证配置 ──
az login

创建第一个 Pulumi 项目

# 使用模板创建新项目（交互式）
mkdir my-infra && cd my-infra
pulumi new aws-python   # Python + AWS
# 或
pulumi new aws-typescript  # TypeScript + AWS

# 项目创建过程中会询问：
# project name: my-infra
# project description: My first Pulumi project
# stack name: dev   ← Stack 是环境的概念
# aws:region: us-east-1

Python 项目结构

TypeScript 项目结构

第一次 pulumi up

以 Python 为例，__main__.py 默认内容已包含一个 S3 Bucket 示例：

# __main__.py（pulumi new 生成的默认内容）
import pulumi
import pulumi_aws as aws

# 创建 S3 Bucket
bucket = aws.s3.BucketV2(
    "my-bucket",
    tags={"Environment": "Dev", "ManagedBy": "Pulumi"},
)

# 导出 Bucket 名称（可在 pulumi stack output 中查看）
pulumi.export("bucket_name", bucket.id)

# 预览变更（不执行）
pulumi preview

# 部署基础设施
pulumi up

# pulumi up 的输出示例：
# Previewing update (dev):
#
#      Type                 Name           Plan
#  +   pulumi:pulumi:Stack  my-infra-dev   create
#  +   aws:s3:BucketV2      my-bucket      create
#
# Do you want to perform this update? yes
#
# Outputs:
#   bucket_name: "my-bucket-a1b2c3d4"
#
# Resources:
#   + 2 created
#
# Duration: 8s

# 查看输出值
pulumi stack output bucket_name

# 销毁资源
pulumi destroy

Pulumi 工作流概览

核心名词解释

本章小结