pulumi-basics
Use when writing infrastructure-as-code with Pulumi using programming languages for cloud resource provisioning.
When & Why to Use This Skill
This Claude skill provides comprehensive guidance and automation for Infrastructure as Code (IaC) using Pulumi. It enables developers to provision, manage, and scale cloud resources across providers like AWS using familiar programming languages. By offering structured templates, command references, and best practices for stack management, it streamlines the transition from manual cloud configuration to automated, version-controlled infrastructure.
Use Cases
- Automated Resource Provisioning: Rapidly define and deploy cloud networking components such as VPCs and subnets using TypeScript instead of manual console clicks.
- Multi-Stack Environment Management: Efficiently manage different deployment environments (dev, staging, prod) using Pulumi stack configurations and secrets management.
- Modular Infrastructure Design: Implement reusable 'Component Resources' and 'Stack References' to build complex, scalable architectures that are easy to maintain.
- CI/CD Pipeline Integration: Incorporate infrastructure previews and updates into automated workflows to ensure consistent and safe deployments.
| name | pulumi-basics |
|---|---|
| description | Use when writing infrastructure-as-code with Pulumi using programming languages for cloud resource provisioning. |
| allowed-tools | [] |
Pulumi Basics
Infrastructure-as-code using real programming languages with Pulumi.
Project Structure
my-infrastructure/
├── Pulumi.yaml # Project file
├── Pulumi.dev.yaml # Stack config
├── index.ts # Main program
└── package.json
Pulumi.yaml
name: my-infrastructure
runtime: nodejs
description: My infrastructure project
TypeScript Example
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
// Create VPC
const vpc = new aws.ec2.Vpc("main", {
cidrBlock: "10.0.0.0/16",
enableDnsHostnames: true,
tags: {
Name: "main-vpc",
},
});
// Create subnet
const subnet = new aws.ec2.Subnet("public", {
vpcId: vpc.id,
cidrBlock: "10.0.1.0/24",
availabilityZone: "us-east-1a",
});
// Export outputs
export const vpcId = vpc.id;
export const subnetId = subnet.id;
Common Commands
# Create new project
pulumi new aws-typescript
# Preview changes
pulumi preview
# Apply changes
pulumi up
# Destroy resources
pulumi destroy
# View stack outputs
pulumi stack output
Configuration
# Set config
pulumi config set aws:region us-east-1
# Set secret
pulumi config set --secret dbPassword mySecret123
# Get config
pulumi config get aws:region
Best Practices
Use Stack References
const infraStack = new pulumi.StackReference("org/infra/prod");
const vpcId = infraStack.getOutput("vpcId");
Component Resources
class MyApp extends pulumi.ComponentResource {
constructor(name: string, args: MyAppArgs, opts?: pulumi.ComponentResourceOptions) {
super("custom:app:MyApp", name, {}, opts);
// Create resources
}
}