Skip to main content

Parameters

The Torque parameter store is a repository of key-value pairs, which can be used and reused in blueprint YAMLs across all spaces in Torque. Two types of parameters are supported:

  • Account-level parameters are defined by the Torque account admin and can be used across all spaces. As such, these parameters are typically used to store data that applies to multiple spaces.
  • Space-level parameters are defined by space admins and apply to specific spaces.

Creating Account-level parameters​

Torque role: Account admin

Important

Modifying or deleting a parameter may cause blueprints that use the parameter to fail.

To add an account-level parameter:

  1. Open the Administration and click Parameters.
  2. Click Add Parameter in the top right corner of the page.
  3. Fill in the details:
    • Parameter Name: Display name for the parameter.
      • Parameter Name is case-insensitive.
      • Parameter Name may only contain URL-supported characters including letters, digits, underscores, dashes, etc.
    • Is Sensitive?: Determines whether this parameter value is sensitive and should be hidden from users
    • Value: Parameter’s value
    • Description: Informative description of the parameter or value it contains
  4. Click Apply. The parameter is stored in the parameter store and can be used in your blueprint YAMLs in the format: {{.params.param-name}}. For details, see Parameters.

Creating space-level parameters​

Torque role: Space admin

To add a space-level parameter:

  1. Open your space, and click Parameters in the left pane. On this page, you can view all the account-level parameters that were defined by the account admin, and add space-specific parameters.
  2. Click the Add Parameter button to add a new space-level parameter.
  3. Fill in the details:
    • Parameter Name: Display name for the parameter.
      • Parameter Name is case-insensitive.
      • Parameter Name may only contain URL-supported characters including letters, digits, underscores, dashes, etc.
    • Is Sensitive?: Determines whether this parameter value is sensitive and should be hidden from users
    • Value: Parameter’s value
    • Description: Informative description of the parameter or value it contains
  4. Click Apply. The parameter is stored in the parameter store and can be used in your blueprint YAMLs in the format: {{.params.param-name}}. For details, see Parameters.
tip

A space-level parameter will take precedence over an account-level parameter with the same name