Purpose

Use these subcommands to run helmfile commands.

atmos helmfile --help

Usage

The helmfile integration passes through all arguments to the helmfile command.

Executes helmfile commands.

atmos helmfile <command> <component> -s <stack> [options]
atmos helmfile <command> <component> --stack <stack> [options]

info

Atmos supports all helmfile commands and options described in Helmfile CLI reference.

In addition, the component argument and stack flag are required to generate variables for the component in the stack.

Additions and differences from native helmfile:

• atmos helmfile generate varfile command generates a varfile for the component in the stack

• atmos helmfile commands support GLOBAL OPTIONS using the command-line flag --global-options. Usage: atmos helmfile <command> <component> -s <stack> [command options] [arguments] --global-options="--no-color --namespace=test"

• before executing the helmfile commands, Atmos runs aws eks update-kubeconfig to read kubeconfig from the EKS cluster and use it to authenticate with the cluster. This can be disabled in atmos.yaml CLI config by setting components.helmfile.use_eks to false

• double-dash -- can be used to signify the end of the options for Atmos and the start of the additional native arguments and flags for the helmfile commands.

tip

Run atmos helmfile --help to see all the available options

Examples

atmos helmfile diff echo-server -s tenant1-ue2-dev
atmos helmfile diff echo-server -s tenant1-ue2-dev --redirect-stderr /dev/null

atmos helmfile apply echo-server -s tenant1-ue2-dev
atmos helmfile apply echo-server -s tenant1-ue2-dev --redirect-stderr /dev/stdout

atmos helmfile sync echo-server --stack tenant1-ue2-dev
atmos helmfile sync echo-server --stack tenant1-ue2-dev --redirect-stderr ./errors.txt

atmos helmfile destroy echo-server --stack=tenant1-ue2-dev
atmos helmfile destroy echo-server --stack=tenant1-ue2-dev --redirect-stderr /dev/stdout

Arguments

Argument	Description	Required
component	Atmos component	yes

Flags

Flag	Description	Alias	Required
--stack	Atmos stack	-s	yes
--dry-run	Dry run		no
--redirect-stderr	File descriptor to redirect stderr to. Errors can be redirected to any file or any standard file descriptor (including /dev/null)		no

note

All native helmfile flags, command options, and arguments are supported

Subcommands

📄️ generate varfile

Use this command to generate a varfile for a `helmfile` component in a stack.