Basics

Whether you’re new to Pulumi or looking to refine your workflow, these guides cover essential practices for organizing infrastructure code, securing deployments, and managing changes with confidence.

These fundamentals apply across all cloud providers and help you build maintainable infrastructure from the start.

Guides

How Pulumi IaC works - Go under the hood to see how the language host, deployment engine, and resource providers work together when you run pulumi up.

Pulumi Cloud vs. OSS - Compare open source Pulumi with Pulumi Cloud across state backends, access management, secrets and configuration, policy enforcement, and workflows.

Language Essentials - Translate the constructs you already use in Pulumi YAML or Terraform HCL, such as variables, conditionals, loops, and modules, into the small set of general-purpose-language constructs a Pulumi program needs.

Organizing projects & stacks - Learn how to structure your infrastructure code into projects and stacks. Understand when to split infrastructure into multiple projects versus using a single project with multiple stacks.

For day-to-day operations — targeted updates, update plans, state file editing, self-managed state backends, least-privilege setup — see Operations.