porter stack

Prerequisites

• You’ve logged in to the Porter CLI after running porter auth login
• You’re connected to the correct project by running porter config set-project
• You’re connected to the correct cluster by running porter config set-cluster
• The project has Stacks enabled

porter stack contains commands to interact with Porter Stacks.

​

Env groups

• To add an env group to a stack, the following command is used:

porter stack env-group add [name] --name <stack name> --namespace <stack namespace>  

• To remove an existing env group from a stack, the following command is used:

porter stack env-group remove [name] --name <stack name> --namespace <stack namespace>  

info

Once an env group has been created and added to a stack using this command, it can be updated using the porter env-group update command.

​

Examples

• To add a new env group to a stack named my-stack in the prod namespace, run the following command:

porter stack env-group add my-env-group --name my-stack --namespace prod -n VAR=VALUE [-n VAR=VALUE ...]  

• To add a new env group to a stack named my-stack in the prod namespace with secret variables, run the following command:

porter stack env-group add my-env-group --name my-stack --namespace prod -s VAR=VALUE [-s VAR=VALUE ...]  

• To add a new env group to a stack named my-stack in the prod namespace and link it to the my-web-app in the same stack, run the following command:

porter stack env-group add my-env-group --name my-stack --namespace prod -n VAR=VALUE [-n VAR=VALUE ...] --linked-apps my-web-app  

​

Flags

• --name (string) name of the stack
• -n or --normal (stringArray) list of normal variables, in the form VAR=VALUE, to set
• -s or --secret (stringArray) list of secret variables, in the form VAR=VALUE, to set
• --linked-apps (stringArray) list of apps in the stack to link the env group to
• --namespace (string) namespace of the stack (default “default”)