技能使用指南

pulumi-basics（Pulumi基础）Skill 是什么？该怎么用？

Pulumi基础Skill把Pulumi项目结构、TypeScript资源示例、preview与up命令闭环、配置与密钥管理、堆栈引用与组件资源整理成AI可调用知识，帮你用编程语言高效编写基础设施即代码，减少参数与流程踩坑。了解它解决什么问题、如何安装验证、与Terraform等方案怎么选，快速上手。

Pulumi基础Skillpulumi-basics
8 个章节 约 17 分钟阅读 AI 智能生成

Pulumi基础Skill：用真实编程语言编写基础设施即代码，让云资源供应像写业务代码一样自然

  • 它是什么：Pulumi基础（pulumi-basics）是一个面向「基础设施即代码」场景的 AI 技能，把 Pulumi 的项目结构、TypeScript 示例、常用命令与最佳实践沉淀成可复用的知识，帮助 AI 助手在你编写云资源代码时给出规范、可直接落地的答案。
  • 解决什么问题：不用再在「Pulumi 官方文档、社区博客、旧版示例」之间来回切换，也不用担心 AI 信口编造一套不存在的配置写法。
  • 核心能力：项目脚手架结构、Pulumi.yaml 与堆栈配置、TypeScript 资源定义（如 VPC、子网）、pulumi new / preview / up / destroy / stack output 等命令、config 配置与密钥管理、堆栈引用与组件资源。
  • 适合谁用：正在用 Pulumi 管理云资源的开发者、需要把「手工点控制台」迁移为代码化的运维与平台工程同学，以及希望让 AI 助手输出可运行基础设施代码的团队。
  • 一句话结论：它不能让 AI 帮你上线业务系统，但能让 AI 在「写云基础设施代码」这件事上少犯错、少返工。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：Pulumi基础Skill 技能英文名：pulumi-basics 技能 ID：13919

这个技能要解决的问题很具体：基础设施即代码（Infrastructure as Code）本身并不难理解，难的是「写对」。各大云厂商的资源参数名、必填项、依赖关系、堆栈组织方式各不相同，开发者常常在参数拼写、资源引用、预览与应用的流程上反复试错。Pulumi基础Skill 把 Pulumi 的项目结构、项目描述文件、TypeScript 资源定义示例、命令行操作序列、配置与密钥管理方式、堆栈引用与组件资源写法整理成结构化的技能知识，让 AI 助手在回答「怎么写一个 VPC」「怎么把数据库密码设成密钥」「怎么引用另一个堆栈的输出」这类问题时，有明确、一致的参照。

需要特别说明的是：根据技能详情，该技能的 user-invocable 为 false，即它是供 AI 助手在后台调用的知识型技能，而不是由用户在对话中显式点名调用的工具型技能。你不需要记住复杂触发词，只要在讨论 Pulumi、基础设施即代码、云资源供应时，它就会以「背景知识」的方式参与回答。

一键安装的思路与步骤（通用流程，具体命令与入口以官方说明为准）：

  1. 确认安装前提：一个支持 AI 技能的市场或技能管理入口（如编辑器的技能面板、命令行技能工具、团队内部的技能仓库等）。由于该技能本身不调用外部工具（allowed-tools 为空），一般不需要额外的 API Key、云账号或付费凭据即可加载。
  2. 检索技能：在技能市场中按中文名「Pulumi基础」或英文名 pulumi-basics 搜索，也可以用技能 ID 13919 精确定位。
  3. 执行一键安装：点击安装 / 添加到工作区，或使用技能管理工具提供的安装指令完成拉取。若你的环境需要登录账号或选择安装范围（个人 / 团队），按提示操作即可，具体步骤以官方说明为准。
  4. 验证是否生效：安装后在本机发起一次验证性提问，例如「用 Pulumi 的 TypeScript 写一个带公有子网的 VPC，并导出子网 ID」。如果回答里出现了规范的项目结构（Pulumi.yaml、index.ts、package.json）、@pulumi/aws 的资源定义写法，以及 pulumi preview / pulumi up 的流程，说明技能知识已正常加载。
  5. 落地检查：任何由 AI 产出的基础设施代码，务必先在非生产堆栈中执行 pulumi preview，确认变更范围符合预期后再 pulumi up。

该技能的主要功能和特点

  • 给出规范的 Pulumi 项目骨架：技能内置标准项目结构，包含 Pulumi.yaml（项目文件）、Pulumi.dev.yaml（堆栈配置）、index.ts（主程序）与 package.json，让 AI 输出的目录树和组织方式有据可依，而不是随手拼凑。
  • 提供可参考的 TypeScript 资源示例：以创建 VPC 与公有子网为例，展示了如何声明资源名、传入 cidrBlock、enableDnsHostnames、tags，以及如何用 vpc.id 建立资源间依赖，并通过 export const 导出输出值。这类示例是「可直接改成自己参数」的起点，而不是伪代码。
  • 覆盖完整的命令闭环：从 pulumi new aws-typescript 创建项目，到 pulumi preview 预览变更、pulumi up 应用变更、pulumi destroy 销毁资源、pulumi stack output 查看堆栈输出，形成「建—看—改—删—查」的完整操作序列。
  • 配置与密钥管理有明确写法：技能明确区分普通配置与秘密配置：pulumi config set aws:region us-east-1 设置区域，pulumi config set --secret dbPassword ... 设置密钥，pulumi config get 读取配置。这一点对很多新手是关键门槛——把密码写进代码是高频事故。
  • 支持堆栈引用（StackReference）：通过 new pulumi.StackReference("org/infra/prod") 再 getOutput("vpcId") 的方式跨堆栈取输出，适合「网络层一个堆栈、应用层一个堆栈」的分层组织。
  • 支持组件资源（ComponentResource）：通过继承 pulumi.ComponentResource 封装自定义抽象资源，把一组相关资源打包成团队内的「标准组件」，避免每个项目重复堆砌相同的资源组合。
  • 和普通工具的差异：一般的代码补全工具只认得语法，不懂「Pulumi 的项目文件长什么样」「密钥该怎么配置」「堆栈之间怎么引用」。这个技能提供的是工程约定层面的知识，回答更接近一位用过 Pulumi 的同事给出的建议。

如何使用该技能？

以下步骤同时适用于「让 AI 助手按技能知识产出代码」和「你自己照着落地」两种用法。

第 1 步：确认技能已加载，并明确你的目标资源 用一句自然语言把需求讲清楚，包括云厂商、语言、资源类型与用途。例如：「用 Pulumi + TypeScript，在 AWS 上创建一个 VPC（10.0.0.0/16）和一个位于 us-east-1a 的公有子网，并导出两者的 ID。」需求越具体，产出的示例越接近可用。

第 2 步：建立项目骨架 按技能给出的结构准备目录：

my-infrastructure/
├── Pulumi.yaml       # 项目文件
├── Pulumi.dev.yaml   # 堆栈配置
├── index.ts          # 主程序
└── package.json

项目描述文件 Pulumi.yaml 的写法参考：

name: my-infrastructure
user-invocable: false
runtime: nodejs
description: 我的基础设施项目

也可以直接用 pulumi new aws-typescript 创建项目，再按需替换为技能里的示例内容。

第 3 步：编写主程序 index.ts 把 AI 给出的示例作为起点，替换为你自己的网段、可用区与标签：

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

// 创建VPC
const vpc = new aws.ec2.Vpc("main", {
    cidrBlock: "10.0.0.0/16",
    enableDnsHostnames: true,
    tags: { Name: "main-vpc" },
});

// 创建子网
const subnet = new aws.ec2.Subnet("public", {
    vpcId: vpc.id,
    cidrBlock: "10.0.1.0/24",
    availabilityZone: "us-east-1a",
});

// 导出输出
export const vpcId = vpc.id;
export const subnetId = subnet.id;

输入说明：资源名（如 main、public）、网段、可用区、标签都是你要按实际情况填的参数。 输出说明：export const 声明的值会成为堆栈输出，可用 pulumi stack output 查看，例如 pulumi stack output vpcId。

第 4 步：配置环境与密钥

pulumi config set aws:region us-east-1
pulumi config set --secret dbPassword mySecret123
pulumi config get aws:region

把区域、账号相关参数与敏感信息放进配置，而不是硬编码在代码里。

第 5 步：预览、应用与清理

pulumi preview   # 预览变更，确认将创建/修改/删除哪些资源
pulumi up        # 应用变更
pulumi destroy   # 销毁资源（谨慎操作）
pulumi stack output

养成「先 preview 再 up」的习惯，尤其是修改已有堆栈时。

第 6 步：按需引入堆栈引用与组件资源 当基础设施规模变大时，用 pulumi.StackReference 跨堆栈读取输出（例如从网络堆栈取 vpcId），或用 pulumi.ComponentResource 把「一套常用资源组合」封装成可复用的类，供多个项目共享。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
Pulumi基础Skill（本技能） AI 助手的基础设施即代码知识技能 项目结构、TypeScript 示例、命令闭环、配置与密钥、堆栈引用、组件资源 低：在技能市场加载即可，无需额外凭据（以官方说明为准） 想让 AI 辅助编写 Pulumi 代码、快速回忆命令与写法 优势：贴近真实工程约定，示例可直接改写；不足：只覆盖 Pulumi 基础用法，不替代官方文档中的完整资源参数表
Terraform（HCL） 业界广泛使用的基础设施即代码工具 声明式 HCL 配置、状态管理、Provider 生态庞大 中：需要单独学习 HCL 语法与状态管理 多云、多团队协作的成熟 IaC 体系 优势：生态与资料极丰富；不足：使用独立 DSL，复杂逻辑表达不如通用编程语言灵活，与本次技能的知识体系不通用
AWS CDK 用编程语言定义 AWS 资源 支持 TypeScript/Python 等语言，直接生成 CloudFormation 中：绑定 AWS 生态，需要理解 CDK 概念层 纯 AWS 环境、希望用代码而非模板管理资源 优势：与 AWS 深度集成；不足：跨云能力弱，迁移到其他云成本较高
云厂商原生模板（如 CloudFormation 模板） 平台原生的声明式模板 YAML/JSON 描述资源，控制台与 CI 集成成熟 中：模板冗长，调试体验一般 单一云厂商的标准化部署、合规场景 优势：平台官方支持、无额外抽象；不足：模板可读性差，复杂条件与循环表达困难
手工控制台操作 点击式资源创建 直观、上手快 低 一次性试验、临时验证 优势：零学习成本；不足：不可复现、不可版本化，与基础设施即代码的理念相反

从上表可以看出，Pulumi基础Skill 的定位并不是「替代某个 IaC 工具」，而是在 Pulumi 这条路线上补上「AI 会不会写对」的短板。如果你的团队已经选定了 Pulumi 的编程语言路线，它带来的提效最明显；如果团队已经在 Terraform 体系里深耕，则不必为此迁移。

该技能的典型应用场景与实际体验情况

场景一：后端开发者第一次接触云资源 角色：刚接手服务部署的 Node.js 开发者。痛点是「知道要建 VPC 和子网，但不知道参数怎么写，也怕删错东西」。使用方式：把需求描述给 AI，得到符合规范的项目结构与 index.ts 示例，先 pulumi preview 看清变更再 pulumi up。实际体验：上手难度低，示例中的资源依赖写法（vpcId: vpc.id）与输出导出直接可复用；注意事项是示例里的网段与可用区必须换成自己环境的真实值，不同区域可用区名称不同。

场景二：平台工程团队统一组件标准 角色：平台工程师。痛点是各业务团队各写一套相似的资源组合，风格不统一。使用方式：借助技能中的 pulumi.ComponentResource 写法，把「应用标配资源」封装成组件类，在团队内共享。实际体验：组件资源的骨架清晰，构造函数里保留资源创建位置，便于逐步填充；注意组件资源需要谨慎设计参数结构，一旦被多个项目引用，后续改动要考虑兼容性。

场景三：多环境分层的堆栈管理 角色：运维工程师。痛点是生产与测试环境混在一个堆栈里，改一处担心影响全局。使用方式：按「网络层一个堆栈、应用层一个堆栈」拆分，用 pulumi.StackReference 取上游输出。实际体验：跨堆栈引用写法简单直接，getOutput("vpcId") 语义明确；注意上游堆栈的输出名一旦变动，下游会取不到值，需要约定输出命名规范。

场景四：敏感配置的安全落地 角色：安全与合规相关同学。痛点是密码、连接串容易出现在代码仓库或聊天记录里。使用方式：参照技能中的 pulumi config set --secret 写法，把密钥放进配置而非源码。实际体验：这一步收益最直接，几乎零成本；注意秘密值仍需配套的权限管理与团队约定，技能只解决「怎么写」，不解决「谁能看」。

该技能能为用户带来的价值

  • 降低入门门槛：不需要先通读整套官方文档，就能得到结构正确、写法规范的项目骨架与资源示例，把「从零到第一个可预览的堆栈」的时间显著压缩。
  • 减少低级错误：项目文件结构、配置与密钥的区分、preview 与 up 的先后顺序，这些高频踩坑点被固化成标准答案，减少「改半天才发现方向错了」的返工。
  • 提升代码一致性与可维护性：堆栈引用与组件资源两种组织方式，让多人协作的基础设施代码有统一的组织范式，长期看能显著降低接手成本。
  • 让 AI 输出更可信：相比通用问答，基于技能知识的回答更贴近真实工程约定，减少「看起来对、跑起来错」的虚假示例，间接降低了在生产环境误操作的风险。
  • 知识沉淀而非个人经验：把「我们团队怎么用 Pulumi」的经验固化为可加载的技能，新人无需逐条询问老同事。

常见问题 FAQ

Q1：这个技能怎么安装？需要付费吗？ A：在支持 AI 技能的市场或技能管理入口中，按中文名「Pulumi基础」、英文名 pulumi-basics 或技能 ID 13919 搜索并一键加载即可。由于该技能不调用外部工具、不需要额外凭据，通常加载即可使用；是否收费、具体安装命令与入口以官方说明为准。

Q2：为什么我在对话里「叫不出」这个技能？ A：根据技能详情，它的 user-invocable 为 false，属于由 AI 助手后台调用的知识型技能，设计上不通过用户显式点名触发。你只需正常提出 Pulumi 相关问题，例如「用 TypeScript 写一个带公有子网的 VPC」，相关规范就会体现在回答中。

Q3：它能帮我把资源直接部署到云上吗？ A：不能。它的 allowed-tools 为空，本身不执行任何部署操作，提供的是编写与操作知识的参考。真正的创建、变更与销毁仍需你在本机执行 pulumi preview、pulumi up、pulumi destroy 等命令，并自行承担云账号与权限配置。

Q4：适合谁用？我不用 TypeScript 还有价值吗？ A：最适合正在或计划使用 Pulumi 管理云资源的开发者与运维同学。技能示例以 TypeScript 呈现，但其中的项目结构、堆栈组织、配置与密钥管理、堆栈引用、组件资源等工程约定，在其他受支持的语言路线中思路是相通的，仍具参考价值。

Q5：和 Terraform 相比该怎么选？ A：如果你希望用通用编程语言表达基础设施、复用现有开发工具链，Pulumi 路线更贴合；如果团队已有成熟的 HCL 规范与状态管理流程，迁移成本需要认真评估。本技能只服务于 Pulumi 路线，不提供 Terraform 相关指导。