pulumi-stacks

The pulumi-stacks provider enables you to import stack outputs from Pulumi into your environment. This includes stacks updated via the Pulumi CLI as well as stacks whose Terraform state is stored in Pulumi Cloud — Terraform root module outputs are mapped to stack outputs and accessible here with no additional tokens or credentials required.

Example

Pulumi stack

values:
  stackRefs:
    fn::open::pulumi-stacks:
      stacks:
        vpcInfra:
          stack: vpc-infra/dev
  pulumiConfig:
    # Consume the stack outputs as Pulumi stack configuration (inputs to your program)
    vpcId: ${stackRefs.vpcInfra.vpcId}
    publicSubnetIds: ${stackRefs.vpcInfra.publicSubnetIds}
    privateSubnetIds: ${stackRefs.vpcInfra.privateSubnetIds}

Terraform state stored in Pulumi Cloud

When a stack’s Terraform state is stored in Pulumi Cloud, the Terraform root module outputs are exposed as stack outputs (using their original snake_case names) and read here with no additional tokens or credentials. You can then map those outputs to either pulumiConfig, to consume them as inputs to a Pulumi program, or environmentVariables, to feed them back into a downstream Terraform run:

values:
  tfStack:
    fn::open::pulumi-stacks:
      stacks:
        network:
          stack: network-tf/production
  pulumiConfig:
    # Consume the Terraform outputs as Pulumi stack configuration (inputs to your program)
    vpcId: ${tfStack.network.vpc_id}
    subnetIds: ${tfStack.network.subnet_ids}
  environmentVariables:
    # Expose the outputs as TF_VAR_* environment variables to feed a downstream Terraform run
    TF_VAR_vpc_id: ${tfStack.network.vpc_id}

Schema reference

Reference schemas last updated on 2026-07-11, synced automatically from the Pulumi Cloud ESC API.

Inputs

• stacks map[string]PulumiStack required
  A map from names to stacks to read from the service. The outputs will map each name to the raw output values for the specified stack.
• ↳ stack string required
  The project-qualified name of the stack to read. e.g., ‘myProjectName/dev’

Outputs

A map from names to raw output values for the specified stack.

Type: map[string]any