pulumi-stack-utils

A collection of utilities for working with Pulumi stacks

The original motivation for this package is to get around some limitations with the StackReference available in the official pulumi Python package. Specifically around reading outputs from other stacks. Currently, stacks need to share the same passphrase to read outputs from each other, even if the output isn't secret.

More information can be found in this issue.

Installation

pip install pulumi-stack-utils

Usage

Retrieve outputs from a stack using an S3 backend

from pulumi_stack_utils import StackReference

# If backend_url isn't provided the package will try and read it
# from the Pulumi.yaml file in the cwd
ref = StackReference("project/my-stack", backend_url="s3://state-backend/prefix")
output = ref.get_output("myOutput")

Autotag resources created on AWS. Based on this blog post

import pulumi
from pulumi_stack_utils.aws.autotag import register_auto_tags

config = pulumi.config()
register_auto_tags({
    "user:Project": pulumi.get_project(),
    "user:Stack": pulumi.get_stack(),
    "user:Owner": config.require("stackOwner"),
})