deploy

Deploy an Altostra project.

$ alto deploy <tagged-deployment> \
       [--env [<environment-name>]] \
       [--config-set <config-file>] \
       [--parameter-map <map-file>]

Arguments

deployment

The deployment and image names, in the form of <deployment-name>:<image>.

Required: yes

Options

--env <environment-name>

Specify the environment for new deployments.

Aliases: -e

Required:

Only when creating a new deployment.

--config-set <config-file>

Specify a configuration file for the deployment.

If specified and the deployment is being updated, it will override the existing deployment configuration.

Aliases: --cs

Required: no

--parameter-map <map-file>

Specify a parameter name mapping file for the deployment.

If specified and the deployment is being updated, it will override the existing deployment parameter mapping.

Aliases: --pm

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 deployment 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 deployment. If a deployment with the given name doesn't exist, the operation will fail.

Aliases: -n

Required:

• Yes, when creating a new deployment and not specifying --env.
• No, when updating an existing deployment.

Providing configuration

If a project has parameters - they all must be satisfied with configuration values from configuration-sets attached to the environment or provided by the --config-set option.

You can provide configuration values in two ways, which are not mutually exclusive:

1. Specify a configuration-set file using the --config-set option
2. Specify an environment using the --new option, when creating new deployment

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 deployment-name:image-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.