Skip to main content

atmos helm plan

Preview the changes a Helm apply would make. plan is an alias for diff: it renders the chart client-side and shows a unified diff against a baseline (the deployed release, a local manifest file, or a GitOps deployment repository). See diff for the full description of baselines and flags.

Usage

atmos helm plan <component> --stack <stack> [options]

# Diff against the deployed release (requires cluster access).
atmos helm plan monitoring -s plat-ue2-dev

# Diff offline against a local manifest or the GitOps deployment repository.
atmos helm plan monitoring -s plat-ue2-dev --from-manifest=current.yaml
atmos helm plan monitoring -s plat-ue2-dev --against=target

# Plan all components tagged "production" (composes with --all/--affected)
atmos helm plan --all --tags production

Flags

--stack, -s (required)
Atmos stack.
--against=<source> / --from-manifest=<path> / --context=<n> (optional)
Select and tune the diff baseline. See diff.
--all / --affected / --include-dependents (optional)
Process multiple Helm components in dependency order.
--tags / --labels (optional)
Filter by tags (comma-separated, matches any) or labels (comma-separated key=value pairs, matches all): --tags=production,tier-1, --labels=cost-center=platform. Compose with --all/--affected to narrow the selected set further; cannot be combined with a single component argument.