Configuring flags for release

4 minute read

You must have Full access within the environment to turn on a flag configuration and release a feature. Any user can configure a flag and request approval for configuration changes. Refer to Requesting approval for flag configurations for more information.

A flag’s Configuration tab allows you to configure a flag using product and user data to determine feature deployment conditions.

This capability allows you to release features based on user properties such as location, device type, language, or dynamic target groups, using custom attributes that are evaluated at runtime.

Conditions can be nested to create more complex flag configuration logic. A nested condition can contain an unlimited number of properties, one target group, one flag, and one version.

You can configure a flag to deploy features to selected users based on the following:

You can configure a flag to gradually deploy features based on the following:

Configuring flags

Once a flag is created, any user can configure a flag from the flag’s Configuration tab.

Refer to Creating feature flags for more information about how to create a feature flag.

To configure a flag:

  1. From the CloudBees Feature Management Home page, select your account from the top right corner, and then select the organization that you want to view.

  2. From the top left corner, select All apps from the left pane, and then select the application.

  3. From the left pane, select Flags in environments, and then select the environment.

  4. Select the existing flag to configure, or select Create flag from the top right corner and create a new flag.

  5. In the Configuration tab, configure the flag as follows:

    • For set to select the flag value from the following options:

      • Value written in the code

      • Override with a new value: <enter value>

    Value is highlighted
    Figure 1. When Override with a new value is selected, the displayed text updates to value.
  6. From the top right corner of the main screen, select one of the following Save Configuration options (select the arrow to display hidden options):

    • Save Configuration (requires Full access): Saves the flag configuration, but does not turn Configuration on. The configuration is only activated when Configuration on is set. Refer to Managing feature releases to turn the configuration on.

    • Save & Activate Configuration (requires Full access): Saves the flag configuration and turns Configuration on.

    • Request Changes: Saves the flag configuration and sends a request to all administrators for approval. The configuration is not activated, even if scheduled to do so. Refer to Requesting approval for flag configurations for more information.

Configuring new conditions and nested statements

You can configure flag conditions in the Configuration tab using the provided fields.

Configuration steps can be reordered by dragging the Dotted rectangle up or down.

You can add more complex logic to your flag configurations by adding nested statements, separated by an and or an or.

To add a new condition and/or nested condition to a flag configuration:

  1. From the CloudBees Feature Management Home page, select your account from the top right corner, and then select the organization that you want to view.

  2. From the top left corner, select All apps from the left pane, and then select the application.

  3. From the left pane, select Flags in environments, and then select the environment.

  4. Select the flag.

  5. In the Configuration tab, select Add new condition. The new condition is framed as the if while the default condition becomes the else.

  6. Configure the flag as follows:

    1. For property (the default option): Select the property, operator, and value.

    2. For target group: Select one or more predefined target groups. Target groups can only be selected when one or more target groups exist.

      Refer to Target groups to learn more.

    3. For flag: Select an existing flag, and choose the flag status. Flag conditions can only be configured when another flag exists.

      Refer to Flag dependencies to learn more.

    4. For version: Select an operator and enter a version number.

  7. Optionally add one or more nested configurations as follows:

    1. Select the + to the right of the flag condition to add a nested condition. Select the - to remove a nested statement.

    2. Next to and, optionally update Matches all the following to matches all conditions or matches any condition, and then configure the nested condition.

      The and updates to or according to the selection.

    The plus and matches and/all conditions is highlighted
    Figure 2. The + adds a new nested condition that can be configured to match any or all conditions.
  8. Configure the then and else if statements according to the configuration options.

  9. From the top right corner of the main screen, select one of the following Save Configuration options (select the arrow to display hidden options):

    • Save Configuration (requires Full access): Saves the flag configuration, but does not turn Configuration on. The configuration is only activated when Configuration on is set. Refer to Managing feature releases to turn the configuration on.

    • Save & Activate Configuration (requires Full access): Saves the flag configuration and turns Configuration on.

    • Request Changes: Saves the flag configuration and sends a request to all administrators for approval. The configuration is not activated, even if scheduled to do so. Refer to Requesting approval for flag configurations for more information.