Skip to main content

atmos aws cloudformation source describe

Use this command to display the source configuration for an aws/cloudformation 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 aws cloudformation source describe --help

Usage​

atmos aws cloudformation 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 aws cloudformation source describe vpc --stack dev

Output:

components:
  "aws/cloudformation":
    vpc:
      source:
        uri: github.com/cloudposse/cloudformation-aws-components//modules/vpc
        version: 1.0.0
        included_paths:
          - "*.yaml"
          - "modules/**"
        excluded_paths:
          - "*.md"
          - "tests/**"

String Format Source​

When source is configured as a simple string:

atmos aws cloudformation source describe vpc --stack dev

Output:

components:
  "aws/cloudformation":
    vpc:
      source:
        uri: github.com/cloudposse/cloudformation-aws-components//modules/vpc?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."aws/cloudformation".<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​