Working with Environments

Environments represent your deployment pipeline: production, staging, or testing. CloudBees Feature Flags supports working with multiple Environments. You can create an unlimited number of Environments and add Flags, Configs, and Experiments to each Environment. CloudBees Feature Flags also allows you to easily migrate Experiments between Environments so anything done in staging or testing can easily be moved to production (and vice versa).

Environments share the following:

  • Flags

  • Target Groups

  • Custom Properties

Environments Do NOT share the following:

  • Experiments

  • Configuration

  • Audit Logs

  • Permissions

Production is the default environment

You can not change the name nor delete the Production environment.

Working with Environments

  • Go to the CloudBees Feature Flags dashboard, on the left sidebar, click on App Settings.

  • Click on the Environments tab.

  • From here, you can make whatever changes you need.

Creating an Environment

  • From the Environments page, click the Add New Environment link.

  • You will be prompted to create your environment.

  • Enter a name for the environment in the Name text box and an optional description for the environment in the Description text box.

  • Click the Generate Key button to proceed.

  • The dialog will now show you your SDK key for this environment. If you want to copy it to the clipboard, you can click the Copy link at the right of the text box (or you can highlight the text and copy manually).

  • When you’re done, click the Close button, and observe that your new environment is now listed in the Environments tab.

  • Also observe that you now see the new environment listed in the navigation bar on the left. Like the default environment, it will have its own settings for Experiments, Configuration, and Audit Logs, which you can see by clicking on it in the navigation bar.

Modifying an Environment

  • From the Environments tab, click on the row of the environment that you wish to modify.

  • You will be prompted with a dialog that allows you to change the name and description of the environment. To do so, make changes in the Name and Description text boxes, respectively, bearing in mind that you cannot leave Name blank.

  • When you are finished making changes, click the Save Changes button to proceed or, optionally, the Cancel button to cancel the changes.

  • Assuming you saved, your changes will be reflected in the Environments tab and any changes you made to its name will appear on the left in the navigation bar.

Deleting an Environment

  • From the Environments tab, move your mouse over the row of the environment you want to delete and observe that a Delete link with a trash can appears. Click that link.

  • A warning message will prompt you, asking if you’re sure you want to delete the environment. Click Delete to proceed and Cancel if you selected this in error.

  • Assuming you opted to delete, you will now see that your environment has been removed from the Environments tab and from the navigation bar on the left.

  • Note that you cannot delete the default environment, Production.

Cloning an Experiment to a new Environment

  • To clone an experiment to a new environment, you’ll need a new environment for which the target experiment is not yet present.

  • Navigate to the environment you wish to clone by clicking its environment in the navigation bar at the left and then clicking Experiments under it.

  • On the Experiments screen, choose the experiment that you wish to clone and click on it.

  • Click the Settings tab at the top, and you’ll see settings for the experiment.

  • Click the Clone To Environment link, and you’ll be prompted with a dialog asking you to select the environment to which you want to clone it.

  • If the experiment already exists in the target environment, the dialog will prompt you to confirm that you want to overwrite the existing experiment. If so, click the Override Experiment button. If this was a mistake, click Cancel.

  • If the experiment does not yet exist in the target environment, to clone it, pick the environment you want to clone it to from the drop-down in the dialog box. To proceed, click the New Experiment button. Otherwise, click Cancel.

  • You will now see the experiment in the target environment on the Experiments screen.

Environments overview

Finally, you can see an overview of all flags for all environments by clicking Flags in the navigation bar on the left. For each environment, you see the status of the flag - Killed, Active, Archived or " - ". You see "-" when a flag was not added to an environment. If you hover over a flag in an Environment you will see the Experiment which is using the flag and if you click it, you will be moved to that Experiment page.