Links

Managing Parameters

CloudTruth Parameters exist across all your Environments in a project and can be made up of a combination of internal and external values. Parameters can also be marked as Secret, which will mask the Parameter's value and store it with additional encryption. Parameters are always scoped to the selected project.
Parameter
Definition
Internal
User defined value per Environment
External
Value obtained from a CloudTruth integration
Secret
Masked Parameter Values protected by additional encryption
In addition, you can apply validation to your parameter values by bounding the value to a specific type and setting custom rules that apply across all environments. You can also mark the Parameter as Dynamic, allowing you to reference other parameters and templates in the value.

Learn more about sharing config data, implicit values, and interpolation.

Adding an Internal Parameter Value

Select a Project to create a Parameter in.
From the Parameter Store page click Add Item to create a new parameter.
Enter a Parameter name, you can select whether the parameter is a secret and provide a description. Expand the Rules to add an optional type and constraints for the parameter.
Click Create Parameter.
The Parameter is created in the default Environment and you can enter an Internal, External or empty value as the Parameter default. Add an Internal value and Click Save.

Secrets

Mark the parameter as a secret to store and treat it with additional security restrictions. Values for Parameters created with the 'secret' option will not be displayed by default wherever the secret is referenced.
Using this option prevents the unnecessary display of sensitive data when performing routine configuration tasks.

Password generation

We provide the ability to generate secure random passwords for you automatically and allow you to specify your minimum requirements. Select the Show Password Generator dropdown.

Dynamic Parameters

Marking a Parameter value as Dynamic allows you to reference and interpolate other values and templates from the project.
This parameter evaluated_demo contains a value with text evaluated_memory_size: that includes the value from a referenced project parameter {{service.app.memory}}.
Clicking Show Evaluated displays the evaluated value for the referenced parameter.
Dynamic values cannot be secrets, but they CAN reference secrets. If you have a secret you'd like to use in a dynamic value, store it in a secret Parameter and reference it in your dynamic value. A dynamic value that references a secret becomes a secret implicitly.

Overriding Parameter Values

Parameters are present in all of the Environments in a project and by default are set to the value from the parent Environment. You can set a unique Parameter value for each Environment by overriding the value.
Click on a Parameter from the Parameter Store list.
The Parameter details page is displayed. In this example we have three Environments (Production, Dev and Staging) under the default parent.
Select the Environment where you would like to override the value and click Edit Value.
The Edit Environment Value page is displayed, set the Parameter value for the selected Environment and click Save.
Now the Parameter details page shows the updated value for the selected Environment. The remaining Environments retain the default value.

Inline Value Edits

Parameters can also be edited from the Parameters, Compare and History pages. On each page the
will allow you to directly edit the value for a specific environment or remove an override. The Compare page will allow you to edit values for each environment selected in the compare.

Searching Parameters

As your Parameter list grows you can use the search to find all parameters with a specific string within your project.
From the Parameter Store page you can list all Parameter values for a specific Environment by selecting the Environment in the drop down box. Values that have overrides for the selected Environment are indicated in the Value Source.

Edit Parameter Settings

Select the Parameter you want to edit from the Parameter Store page and click Edit Parameter Settings from the Parameter menu.
The Edit Parameter dialogue allows you to update the description, change whether the parameter is a secret and update or set rules.

Deleting Parameters

Select the Parameter you want to edit from the Parameter Store page and click Delete Parameter from the Parameter menu.

Template References

The Parameter settings page will display the number of Templates a given Parameter is referenced in. You can navigate to each Template from the Template List tab. Parameters that are referenced in a template are protected from deletion.