Skip to main content

atmos packer source describe

Use this command to display the source configuration for a Packer component. This shows the source URI, version, and any path filters configured for vendoring.

Source-Based Version Pinning

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

atmos packer source describe --help

Usage​

atmos packer source describe <component> --stack <stack>

Description​

The describe command extracts and displays the source configuration from a component's stack manifest. The output matches the stack manifest schema format, making it easy to copy and paste into your configuration. This is useful for:

  • Verifying source configuration before vendoring
  • Checking the version configured for a component
  • Reviewing included/excluded path filters
  • Debugging source provisioning issues

Examples​

View Source Configuration​

Display the source configuration for a component:

atmos packer source describe ami-builder --stack dev

Output:

components:
  packer:
    ami-builder:
      source:
        uri: github.com/cloudposse/packer-templates//ami-builder
        version: 1.0.0
        included_paths:
          - "*.pkr.hcl"
          - "scripts/**"
        excluded_paths:
          - "*.md"
          - "tests/**"

String Format Source​

When source is configured as a simple string:

atmos packer source describe docker-builder --stack dev

Output:

components:
  packer:
    docker-builder:
      source:
        uri: github.com/cloudposse/packer-templates//docker-builder?ref=1.0.0

Arguments​

component
Required. The name of the Atmos component to describe.

Flags​

--stack / -s
Required. The Atmos stack name. Can also be set via ATMOS_STACK environment variable.

Output Format​

The command outputs YAML matching the stack manifest schema:

components.packer.<component>.source
The parsed source specification for the component.
source.uri
The go-getter-compatible source URI.
source.version
The version tag, branch, or commit (if specified separately).
source.included_paths
List of glob patterns for files to include.
source.excluded_paths
List of glob patterns for files to exclude.

See Also​