Create an Environment

Creating an environment helps organize and manage applications at different stages of the software lifecycle.

How to create an environment?

Navigate to the project you wish to create an environment in and select Environments. Click New Environment to begin environment configuration.

Image loading...

Click New Environment to begin environment configuration.

Image loading...

Environment configuration

• Name - The name generates a unique identifier (ID), which can be manually edited to match your workflow, such as Dev Workspace, Staging Preview, or Production Live.

• Icon (Optional) - Select an icon from the list.

• Type - Choose a type of environment from the available options: Dev, Stage, Production

• URL (Optional) - Provide an app URL e.g. https://staging.myproduct.com.

• Tags (Optional) - Tag your environments.

Image loading...

Once done, you can now see your environment on the list.

Image loading...

Assigning environment to pipelines.

With the environments created, you can assign them to pipelines in the Environment Context section of the pipeline settings.

Image loading...

You can either select a specific environment or use matching filters.

Image loading...

Matching filters Environments

You can filter the environments based on their ID, Type or tags. That way, instead of manually assigning each environment, you can automate the process.

All criteria (ID, TYPE, TAGS) are applied simultaneously using the logical AND operator. This means that an environment must meet all conditions to be selected. However, it's important to note that multiple contexts with different filters can be added to a pipeline. So, even though the AND operator is used within a single filter, you can include different variations.

Image loading...

ID filtering

Environment ID is unique, unlike the Name field (Environment name), which can be arbitrary and changed for organizational purposes. It is recommended to use the ID when matching environments in the Match Filters section.

In the ID field, you can use regular expressions (regex) to easily match environments with a specific naming pattern.

Examples:

• *stage - matches all environments that ID end with stage.
• stage_* - matches all environments that ID begin with stage_.
• * - matches all available environments regardless of the name.

Tag filtering

Tags enable the organization and search of environments based on assigned tags. Regex does not work in the Tags field – you must select the exact tag name from those previously used.

Image loading...

Create an Environment using REST API

Besides the user interface, environments can also be created using Environment REST API, allowing for quick and automated deployment.