As you work with variables in Octopus, there may be times when the value of a variable isn’t known and you need a user to enter the variable at deployment time. Octopus can handle this using Prompted variables.
Defining a prompted variable
To make a variable a prompted variable, enter the variable editor when creating or editing the variable. On the variable value field, click Open Editor:
When defining a prompted variable, you can provide a friendly name and description, and specify if the value is required. A required variable must be supplied when the deployment is created and must not be empty or white space.
You can identify prompted variables by looking for the icon next to the value:
You can select one of several different data types. This controls the user interface provided to collect the variable value, and determines how the variable value is interpreted. Note the variable values will be stored and interpreted as text. Control type options are:
- Single-line text box
- Multi-line text box
- Drop-down
- Checkbox
Providing a value for the variable
When deploying (not creating a release), you’ll be prompted to provide a value for the variable:
These variables will be ordered alphabetically by label (or name, if the variable label is not provided).
A value can also be passed to a prompted variable when using the Octopus CLI through the --variable parameter of the Deploy-Release command, or the Create-Release command when also deploying the release with the --deployto parameter.
octo deploy-release ... --variable "Missile launch code:LAUNCH123" --variable "Variable 2:Some value"
Prompted variables can be combined with sensitive variables. They will appear with a password box when creating the deployment. They can also be combined with Azure Account variables, AWS Account variables, Certificate variables, and Worker Pool variables, passing in the ID, e.g. WorkerPools-1.
Restricting a prompted variable for runbooks
By default, a prompted variable will prompt when deploying a release and when executing any runbooks in the project.
Prompted variables can be scoped to specific processes, causing them to only be shown when deploying releases, or only when executing runbooks.
Prompted variable ordering
When Octopus renders prompted variables for a deployment or runbook, they are sorted alphabetically by the prompted variable label. If you want to customize the order in which the variables appear, one option is to include a numerical prefix in the label:
Learn more
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Thursday, August 29, 2024