Skip to main content

atmos terraform source list

Use this command to list all Terraform components that have source configured. This shows which components can be vendored using the source provisioner.

Source-Based Version Pinning

Learn how to configure the source field for per-environment version control.

atmos terraform source list --help

Usage​

atmos terraform source list [component] [flags]

Description​

The list command scans component configurations and displays all Terraform components that have source defined. This helps identify:

  • Which components are configured for JIT vendoring
  • The source URIs and versions for each component
  • Components that may need to be vendored before use
tip

To list sources across all component types (Terraform, Helmfile, Packer) in a unified view, use atmos list sources.

Examples​

List All Terraform Sources Across All Stacks​

atmos terraform source list

Output:

STACK              COMPONENT    URI                                                           VERSION
plat-ue2-dev       eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.450.0
plat-ue2-dev       vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0
plat-ue2-prod      eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.451.0
plat-ue2-prod      vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.451.0

List Sources in a Specific Stack​

atmos terraform source list --stack plat-ue2-dev

When filtering by stack, the Stack column is omitted:

COMPONENT    URI                                                           VERSION
eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.450.0
vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0

List Sources for a Specific Component​

atmos terraform source list vpc

Shows the component across all stacks:

STACK              COMPONENT    URI                                                           VERSION
plat-ue2-dev       vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0
plat-ue2-prod      vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.451.0

Output in Different Formats​

# JSON format
atmos terraform source list --format json

# YAML format
atmos terraform source list --format yaml

# CSV format
atmos terraform source list --format csv

# TSV format (tab-separated, for pipelines)
atmos terraform source list --format tsv

Dynamic Columns​

The command automatically adjusts columns based on context:

ContextColumns Shown
All stacksStack, Component, Folder*, URI, Version
Single stack (--stack)Component, Folder*, URI, Version

*The Folder column only appears when any component uses metadata.component to specify a different folder name than the component instance name.

Arguments​

component (optional)
Filter results to a specific component name or folder (metadata.component). When provided, only shows sources for components matching this name across all stacks.

Flags​

--stack / -s (optional)
Filter by stack name. When provided, only shows sources within that stack and omits the Stack column from output.
Environment variable: ATMOS_STACK
--format / -f
Output format: table, json, yaml, csv, tsv (default: table).
Environment variable: ATMOS_FORMAT

See Also​