Join us at the Cloud Engineering Summit on October 20th for a free day of learning. Save your spot.

Projects and Stacks

Projects group stacks together and are folders containing a Pulumi.yaml file. Stacks are isolated, independently configurable instances of a Pulumi program. Projects can have as many stacks as you need.

Creating a Project

To create a project:

  1. Navigate to Projects.
  2. Select Create project.
  3. Select a cloud and a language and use the Next button.
  4. Optionally, change your project name and project description.
  5. Select Create project.
  6. Follow the provided CLI command instructions.

Stack Permissions

The Pulumi Console provides fine-grained access controls for stacks. Stack permissions are based on the member’s role within the organization, and on their team membership. Additionally, any member who creates a stack is granted admin permissions on that stack.

Organization admins can control the stack default permissions at the organization level from the organization’s Settings. There are four types of stack permissions: None, Read, Write, and Admin. Team permissions will expand these default permissions.

Stack permissions allow users to perform the following actions:

ActionNoneReadWriteAdmin
View update history
Decrypt secret configuration
Read stack resources
Preview stack changes
Update stack
Destroy stack (pulumi destroy)
Export stack checkpoint
Import stack checkpoint
Delete stack (pulumi stack rm)
Transfer to another organization

Viewing Stacks

Organization projects and stacks

To view an organization’s stacks:

  1. Navigate to Projects.
  2. Optionally, adjust the grouping by selecting the Group By and Sort By controls.
  3. To view a stacks details select the name of the stack.
  4. To view a specific stack update, navigate to Activity and select it from the list.

Stack Detailed View

To view a stack’s details:

  1. Navigate to Projects and then a specific stack.
  2. Navigate to Activity.
  3. Review the stack’s outputs, configuration values, and tags.

Stack outputs and configuration

You can see other details such as who applied the update and when, as well as counts of added, updated, and unchanged resources. If your stack is integrated with a CI/CD pipeline, such as GitHub Actions, you also see useful links to data like your Git commit hash, mapped branch, and pull request ID.

Custom Stack Tags

Custom stack tags can help you group and filter your stacks.

Stack tags

To create a custom tag:

  1. Navigate to Projects and then a specific stack.
  2. Select New tag.

To modify or delete a custom tag:

  1. Navigate to Projects and then a specific stack.
  2. To modify a custom tag, use the pencil icon.
  3. To delete a custom tag, use the trash can icon.

Stack Activity

To view stack activity:

  1. Navigate to Projects and then a specific stack.
  2. Navigate to Activity.
  3. Review insights and operations that were performed on your stack resources during the update.
  4. Navigate to Changes, Timeline, or Configuration for more details.

The Changes section of activity lets you toggle between different log views:

  • Summary Log which lists a summary of changes, counts of affected resources, and update duration
  • Diff Log which displays a diff of the changes (created, updated, or deleted resources), your stack outputs, and the same counts and update duration shown in the Summary Log view.
  • Diagnostic Log which displays warning messages or a description of the operations performed during the update (if any).

Stack resource graph

The Timeline section provides a detailed timeline of changes to individual cloud resources. It also includes useful resource links and counts of affected resources.

Stack resource graph timeline

The Configuration section displays the same configuration details that you can find in the Stack view for your update.

Stack Resources

To view a stack’s resources:

  1. Navigate to Projects and then a specific stack.
  2. Navigate to Resources.
  3. Select List View or Graph View to toggle between a list view and a graph view.
  4. Selecting an individual resource from the list or graph view will provide more details.

The list view displays a list of all of the stack’s resources including their type, name, status, and link to the associated cloud provider.

Stack resource list

The graph view displays a graphical representation of the stack’s resources and their dependencies. Select an individual resource to view its list of properties and dependencies.

Stack resource visualization

Transferring Stacks

Stack admins can transfer their stacks between personal accounts and organizations or between organizations.

If transferring to an organization, the Allow organization members to create stacks and transfer stacks to this organization setting must be turned on from the Access Management page in the organization’s settings.

To transfer a stack:

  1. Navigate to the stack, and then the stack’s Settings.
  2. Select Transfer stack.
  3. Provide the personal account or organization name and select Transfer.

Deleting a Stack

Deleting a stack removes the stack entirely from the Pulumi Service, along with all of its update history.

To delete a stack:

  1. Navigate to Projects and then a specific stack.
  2. Navigate to the stack’s Settings.
  3. Follow the instructions in the Danger Zone.