Creating environment gates

To create an environment gate, specify the conditions that must be met before component versions can be deployed to the environment.

Before you begin

Create one or more component version statuses. To see available statuses, click Settings > Statuses and then under Version Statuses, click Add Status.

Procedure

  1. Display the Environment Gates pane for the target application or application template (Applications > selected application > Configuration > Environment Gates or Applications > Templates > selected application template > Configuration > Environment Gates).
    This pane lists the environments and the gates for each environment.
    Note: You cannot modify environment gates if the environment was created by using an application template.
  2. Next to an environment, click on No gate selected and a list of statuses will become visible.
    Selecting environment gates

    The available statuses are defined in the default.xml file. You supply your own status values.

    Selecting a value provides both And and Or selection boxes. Once you add a status you can click the green check mark to turn it into a circle-backslash symbol, which gives the status a Not operation.

    Environment gate showing "and", "or", and "not".

    Using the And box adds another value to the condition that must be satisfied. For example, if you define a gate with the conditions Passed unit tests and Latest, only component versions with both of these statuses can be deployed into the environment.

    Using the Or box adds another condition to the gate. Additional conditions are defined in the same way as the first one. A gate with two or more conditions means that the component version can be deployed if it meets any of the conditions. For example, if you define a gate with the conditions Passed unit tests and Latest, a component version passes the gate if it has either status (or both). A single gate can have any number of conditions.

    Applying Not to a status adds a value to the gate that will exclude the status from deployment. For example. if you define a gate with the condition (circle-backslash symbol) Failed tests, the component versions with this status will not be deployed into the environment.

  3. Repeat these steps for other environments.
    Each environment can have different gates.
  4. Click Save Gates to save your changes.

Results

Component versions cannot be deployed to the environments unless they have the specified statuses. To assign statuses to component versions, see Statuses.