Every Pulumi program is deployed to a stack. A stack is an isolated,
instance of a Pulumi program. Stacks are commonly used to denote different
phases of development (such as
feature branches (such as
A project can have as many stacks as you need. By default, Pulumi creates a
stack for you when you start a new project using the
pulumi new command.
Create a stack
To create a new stack, we use the command
pulumi stack init name. This
command creates an empty stack
name and sets it as the active stack.
The project that the stack is associated with is determined by finding the
The stack name must be unique within a project. Stack names may only contain alphanumeric characters, hyphens, underscores, or periods.
Let’s create a new stack in our project, for our staging environment:
$ pulumi stack init staging
We have a couple of stacks in our project now—but how do we know which
ones we have? If we run the command
pulumi stack ls, it will tell us!
$ pulumi stack ls NAME LAST UPDATE RESOURCE COUNT URL dev 2 minutes ago 10 https://app.pulumi.com/***/my-first-app/dev staging* n/a n/a https://app.pulumi.com/***/my-first-app/staging
Notice that the
staging stack has an
* after its name; this asterisk marks
this stack as the active stack (i.e., the stack that all our commands will run
When we run a Pulumi command (such as
destroy), the command
operates on the active stack. But what if we want to change which stack is
active? For this task, we use the
pulumi stack select command:
$ pulumi stack select dev $ pulumi stack ls NAME LAST UPDATE RESOURCE COUNT URL dev* 3 minutes ago 10 https://app.pulumi.com/***/my-first-app/dev staging n/a n/a https://app.pulumi.com/***/my-first-app/staging
dev is now the active stack.
Next up, we’re going to explore how to get information out of a stack to use in other places, like elsewhere in our program or in general spots like your browser.
Thank you for your feedback!
If you have a question about how to use Pulumi, reach out in Community Slack.
Open an issue on GitHub to report a problem or suggest an improvement.