atmos stack config

atmos stack config is the canonical command set for reading, editing, and listing component-relative config paths (e.g. vars.region) for a component in a stack. It runs the same provenance-aware engine as the flat atmos stack get|set|delete|format commands — those are convenience aliases of the get/set/delete/format subcommands here — plus list, which has no flat equivalent (a flat atmos stack list would collide with the existing atmos list stacks).

atmos stack config --help

Usage

atmos stack config get <path> -s <stack> -c <component>
atmos stack config set <path> <value> -s <stack> -c <component> [--type <type>] [--file <manifest>]
atmos stack config delete <path> -s <stack> -c <component> [--file <manifest>]
atmos stack config format -s <stack> -c <component> [--file <manifest>]
atmos stack config list [path-pattern] -s <stack> -c <component> [--format <format>]

Paths are component-relative (e.g. vars.region, settings.spacelift.workspace_enabled).

Subcommands

delete

Delete a component-relative value from the stack manifest that defines it.

format

Format the manifest files that define a stack component.

get

Read a component-relative value from a stack and show which manifest defines it.

list

List editable component config paths for a stack.

set

Set a component-relative value in the stack manifest that defines it, preserving comments, anchors, and templates.

Examples

# Read a value and see which manifest defines it.
atmos stack config get vars.region -s plat-ue2-prod -c vpc

# Set the value in the file that currently provides it.
atmos stack config set vars.region us-west-2 -s plat-ue2-prod -c vpc

# Delete a value from the manifest that defines it.
atmos stack config delete settings.spacelift.workspace_enabled -s plat-ue2-prod -c vpc

# Format the manifest files that define the component.
atmos stack config format -s plat-ue2-prod -c vpc

# List every editable path for the component.
atmos stack config list -s plat-ue2-prod -c vpc

Related

• atmos stack get, atmos stack set, atmos stack delete, atmos stack format — flat aliases of get/set/delete/format here.