deploy
Deploy an Altostra project.
Deploy an existing version of the project
This command will deploy using the given version name. The version must already exist.
alto deploy <stack-name>:<version-name> \
[--env [<environment-name>]] \
[--config-set <config-file>] \
[--parameter-map <map-file>]
Deploy a new version of the project
This command will first create and push a new version by the given name and then it will deploy that version. A version by that name must not exist.
alto deploy <stack-name>:<version-name> --push \
[--env [<environment-name>]] \
[--config-set <config-file>] \
[--parameter-map <map-file>]
Deploy a new version of the project without specifying the version name
This command will first create and push a new version with an auto-generated version name and then it will deploy that version.
Use this command to quickly deploy project when version names are not important, such as during testing or in scripts.
alto deploy <stack-name> \
[--env [<environment-name>]] \
[--config-set <config-file>] \
[--parameter-map <map-file>]
Arguments
stack-name
The stack name.
Required: yes
version-name
The version name.
When the --push
option is used, the :<version>
part can be omitted.
In this case - a version name is auto-generated based on the current date and time.
When a version name :<version>
is not provided, --push
is assumed.
Required: no
Options
--env <environment-name>
Specify the environment for new stacks.
Aliases: -e
Required:
Only when creating a new stack.
--config-set <config-file>
Specify a configuration file for the stack.
If specified and the stack is being updated, it will override the existing stack configuration.
Aliases: --cs
Required: no
--parameter-map <map-file>
Specify a parameter name mapping file for the stack.
If specified and the stack is being updated, it will override the existing stack parameter mapping.
Aliases: --pm
Required: no
--push
Push and deploy a version using only the deploy
command.
This is equivalent to running the push
command and then the deploy
command with the same version name.
Aliases: --new-version
Required: no
--project-path
Specify the project working directory.
If not specified, the project directory is assumed to be the current directory.
Aliases: --pp
Required: no
--project
Specify the project ID to deploy if it differs from the one stored in .altostra/project.json
.
This option is useful if you want to perform operations on a specific project in a script when there isn't a working project directory.
Aliases: -p
Required: no
--new <environment-name>
Deprecated: Use '--env' instead.
Create a new stack in the specified environment instead of updating an existing one.
When --env
is not specified and --new
is not set, the default action is to update an existing stack. If a stack with the given
name doesn't exist, the operation will fail.
Aliases: -n
Required:
- Yes, when creating a new stack and not specifying
--env
. - No, when updating an existing stack.
--force-import
Import the project to the working Altostra account if it does not already exist.
Required: no
Providing configuration
If a project has parameters - they all must be satisfied with configuration values from the environment or provided by the --config-set
option.
You can provide configuration values in two ways, which are not mutually exclusive:
- Specify a configuration-set file using the
--config-set
option - Specify an environment using the
--new
option, when creating a new stack
If you use both these options together, the values from the configuration file will take precedence over the values in any of the configuration sets in the given environment.
alto deploy stack-name:version-name \
--config-set config.json \
--environment my-env
Parameters mapping
A parameters-map file may be used to map between parameter-names expected by the project, and the provided configuration values in the configuration-set.