Search…
Environment parameters
Control environment orchestration using dynamically set parameters
Environment parameters are placeholders defined in your Velocity account, allowing users to control their environment provisioning. When creating or updating an environment, the user can set custom values to the predefined parameters and control the environment provisioning.
Common use cases for environment parameters:
  • Changing environment variables that affect your application's behavior. For example: selecting a tenant or enabling certain features.
  • Changing environment size. For example, changing the number of instances of a certain service.

Defining parameters

Environment parameters and their associated default values are created via the Velocity UI.
To do so, click on your user icon in the top right corner of the UI. Then select Account Settings. You can then select the Account parameters option, and click Add new parameter to create a new environment parameter and its associated default value.
Example:

Overwriting parameters

At the time of environment creation, a user may overwrite the default value associated with a given environment parameter, like so:
veloctl env create --param 'tenant-id=3'
NOTE: in the above veloctl example, the enviornment parametertenant-id must have first been created with a default value via the Velocity UI, as shown above.
NOTE: If no --param value is passed, the default value will be used.
Changing the available parameters does not impact running environments.
To update running environments, use veloctl env update as defined below.

Listing the environment parameters

Once Velocity defines parameters in your account, you can list them by running veloctl env list-parameters
The list-parameters command prints the names of the parameters and their default values.

Updating an existing environment with parameters

When you have an existing environment, you can update some of the services or all of them using the veloctl env update command. Updating the environment allows you to change the predefined parameters using the --param flag.
For example:
  • Full update - updating all the services in the environment: env update --param 'tenantId=3'
  • Partial update - updating selected services in the environment: env update -s website --param 'tenantId=3'
Please note that when running a partial update, the new values set in the update command will only affect updated services.
Copy link
On this page
Defining parameters
Overwriting parameters
Listing the environment parameters
Updating an existing environment with parameters