Go语言Pulumi基础设施编程_Golang声明式云资源管理-Golang-PHP中文网

go语言写pulumi不是“纯go”，必须通过pulumi cli加载执行，依赖cli、登录状态和后端配置；go run main.go仅编译运行而不触发iac流程，需用pulumi up或preview启动引擎解析代码并驱动部署。

go语言pulumi基础设施编程_golang声明式云资源管理

Go 语言写 Pulumi 不是“纯 Go”，它依赖 pulumi CLI 和远程状态服务；不装 CLI、不登录、不设 backend，pulumi up 必然失败。

为什么 `go run main.go` 不能部署资源

Pulumi 的 Go 程序不是直接执行的可执行文件，而是被 pulumi CLI 加载并解析为中间表示（IR），再由引擎驱动云 API。你写的 main.go 本质是“描述器”，不是“运行器”。

go run main.go 只会编译并运行一次，不会触发资源预览/创建逻辑，也读不到 stack 配置
必须用 pulumi up 或 pulumi preview 启动 CLI 才能加载 Go 代码、解析依赖、比对状态、生成计划
CLI 会自动调用 go build -buildmode=plugin（v3 SDK 默认行为）生成插件，再注入 runtime 上下文

`pulumi login` 和 `PULUMI_BACKEND_URL` 必须显式配置

默认状态下，Pulumi 将 state 存在云端（app.pulumi.com），但 Go 项目常用于私有 CI 或离线环境，此时必须手动指定本地后端，否则 pulumi up 会卡在登录或报错 no valid login method found。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

启用本地 state：运行 pulumi login --local，或设环境变量 PULUMI_BACKEND_URL=file://./state
路径必须是绝对路径或以 file:// 开头的相对路径；./state 不合法，file://./state 才合法
若混用不同 backend（比如先用 cloud 登录，又切到 file），需用 pulumi stack select 显式切换，否则 CLI 仍尝试连云端

Go SDK 初始化必须调用 `pulumi.Run`，且仅一次

入口函数必须是 func main() { pulumi.Run(...)，否则 CLI 无法识别为有效 Pulumi 程序。常见错误是漏掉 pulumi.Run、包名不是 main、或在 Run 外部提前 return。

正确结构：

package main

import (
    "github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3"
    "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        _, err := s3.NewBucket(ctx, "my-bucket", &s3.BucketArgs{
            Bucket: pulumi.String("my-unique-bucket-name-12345"),
        })
        return err
    })
}

不能在 Run 外部定义资源（如把 s3.NewBucket 写在 func main() 顶层），会 panic：context is nil
一个 main.go 文件只能有一个 pulumi.Run 调用；多 stack 场景应拆成多个项目，而非多个 Run

Provider 配置不写死，用 `pulumi config` 动态注入

硬编码 region、accessKey 等会导致代码不可复用、泄露密钥、无法跨环境。Pulumi 提供了基于 stack 的配置机制，应优先使用。

设置配置：pulumi config set aws:region us-west-2，敏感值加 --secret
在代码中读取：region := pulumi.Config{"aws"}.Require("region")，注意 provider 名称（aws）要和实际 provider 包一致
若 provider 名称拼错（如写成 awsx 但没 import 对应包），pulumi preview 会静默跳过该资源，无报错但也不创建
Provider 版本必须与 SDK 版本匹配：用 github.com/pulumi/pulumi-aws/sdk/v6 就得配 v6 的 provider，否则 pulumi up 报 provider not found