Skip to main content

atmos aws cloudformation source list

Use this command to list all aws/cloudformation 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 aws cloudformation source list --help

Usage​

atmos aws cloudformation source list [component] [flags]

Description​

The list command scans component configurations and displays all aws/cloudformation 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, aws/cloudformation) in a unified view, use atmos list sources.

Examples​

List All aws/cloudformation Sources Across All Stacks​

atmos aws cloudformation source list

Output:

STACK              COMPONENT    URI                                                                 VERSION
plat-ue2-dev       vpc          github.com/cloudposse/cloudformation-aws-components//modules/vpc     1.0.0
plat-ue2-prod      vpc          github.com/cloudposse/cloudformation-aws-components//modules/vpc     1.1.0

List Sources in a Specific Stack​

atmos aws cloudformation source list --stack plat-ue2-dev

When filtering by stack, the Stack column is omitted:

COMPONENT    URI                                                                 VERSION
vpc          github.com/cloudposse/cloudformation-aws-components//modules/vpc     1.0.0

List Sources for a Specific Component​

atmos aws cloudformation source list vpc

Shows the component across all stacks:

STACK              COMPONENT    URI                                                                 VERSION
plat-ue2-dev       vpc          github.com/cloudposse/cloudformation-aws-components//modules/vpc     1.0.0
plat-ue2-prod      vpc          github.com/cloudposse/cloudformation-aws-components//modules/vpc     1.1.0

Output in Different Formats​

# JSON format
atmos aws cloudformation source list --format json

# YAML format
atmos aws cloudformation source list --format yaml

# CSV format
atmos aws cloudformation source list --format csv

# TSV format (tab-separated, for pipelines)
atmos aws cloudformation 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​