Skip to main content

atmos packer source list

Use this command to list all Packer 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 packer source list --help

Usage​

atmos packer source list [component] [flags]

Description​

The list command scans component configurations and displays all Packer 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 Packer Sources Across All Stacks​

atmos packer source list

Output:

STACK              COMPONENT       URI                                                    VERSION
plat-ue2-dev       ami-builder     github.com/cloudposse/packer-templates//ami-builder    1.0.0
plat-ue2-dev       docker-builder  github.com/cloudposse/packer-templates//docker         1.0.0
plat-ue2-prod      ami-builder     github.com/cloudposse/packer-templates//ami-builder    1.1.0

List Sources in a Specific Stack​

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

When filtering by stack, the Stack column is omitted:

COMPONENT       URI                                                    VERSION
ami-builder     github.com/cloudposse/packer-templates//ami-builder    1.0.0
docker-builder  github.com/cloudposse/packer-templates//docker         1.0.0

List Sources for a Specific Component​

atmos packer source list ami-builder

Shows the component across all stacks:

STACK              COMPONENT       URI                                                    VERSION
plat-ue2-dev       ami-builder     github.com/cloudposse/packer-templates//ami-builder    1.0.0
plat-ue2-prod      ami-builder     github.com/cloudposse/packer-templates//ami-builder    1.1.0

Output in Different Formats​

# JSON format
atmos packer source list --format json

# YAML format
atmos packer source list --format yaml

# CSV format
atmos packer source list --format csv

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