Before you begin, this documentation assumes the following:
You have created a Project.
An Environment is a group of applications and databases running within the same namespace. A Project can have multiple Environments.
Create an environment
You can create a new environment by clicking on the
Create environment button of the Project page. A modal will appear that will allow you to specify following parameters
- name: Give a name to your environment that is easily recognizable by anyone from your team. It is good practice to name your environment
feat/xxx, depending on the purpose of your environment.
- mode: Specify environment mode. See Types of environment section.
- cluster : Specify the organization cluster on which this new environment will be deployed.
Have a look at the Deployment Management section for more information.
Deployment rules and automatic option.
cluster parameters are set as "automatic".
Automatic option is specified for one or both of these parameters, deployment rules will automatically select the
cluster and the
mode you specified in it.
If you chose to specify a cluster and/or a mode during the environment creation, the deploymment rules will also be applied, but the
cluster and the
mode will be overwritten by the one you just specified.
If you let
Automatic option and that no deployment rule catch this new environment, the default
cluster will be applied.
When you start using Qovery heavily, your environment list can look like this
Edit environment general settings
General settings of an environment can be updated in the settings panel. Your can access to it by clicking on the
General tab, you will be able to update your environment name. It will also display the environment mode and the cluster assigned to your environment.
Use Preview Environment to get early feedback on your application changes.
The purpose of an Environment is to manage a bunch of applications that are working all together. Your production environment runs 24/7, where your other environments may not need to run all day long. E.g. you may need to run Environments to get early feedback on your application changes before the changes are merged into production. This is what we call Preview Environment.
Sometimes Preview Environment are also known as Ephemeral Environment, Temporary Environment, Development Environment.
Creating a Preview Environment is similar to create a casual Environment.
Build and Deployment logs
Sometimes, you need to have a closer look on what is going on while an operation (see statuses) is in progress.
Click on the
show logs button to watch your deployment logs in real-time.
Cloning an environment is possible if you want to create an Environment from another one.
Environment clone is convenient for those use cases:
- Make a demo without impacting the original Environment.
- Validating a feature that needs to reflect the original Environment.
Types of environment
You can define a specific mode for an environment, to label it and share with others in the organization how to use it. Here is the mode you should set depending of the use of your Environment.
|environment mode||recommended mode||why|
|production||Production environment should not be stopped or deleted by anyone.|
|Staging||Staging environment reflects how things work and is sometimes as critical as production for companies.|
|Development||Develoment environment is a working environment that could be used to develop and test new features and fixes.|
Moreover, Preview environment mode will be automatically set as
It is possible to go beyond than the basic configuration for an Environment. Here is a list of advanced features available for your environments.
Auto-Deploy environment feature allows you to control if your applications should be, by default, automatically updated after receiving new commits. This feature is part of the Environment deployment rules feature.
Auto-delete environment feature allows you to control if your applications should be, by default, automatically deleted after branch merging or deletion. This feature is part of the Environment deployment rules feature.
The Deployment Rules lets you configure the lifecycle of your Environments.
Refer to the Deployment Rule documentation to know more.
You can easily access to the deployments history of your environment by clicking on deployment
history button in
This page allows you to view the history of all previous deployments of your environment and their status. By clicking on the extension button, you will also be able to view the services deployed in the environment and their deployment status.
Cancel an environment deployment
It may happen that you launch an unwanted deployment (setting error, wrong commit deployed, etc.) and you want to cancel the deployment, rather than waiting for the action to be completed and then performing a rollback, which can be time consuming.
To cancel a deployment, click on
Cancel deployment in the
Action menu of your environment.
Delete an environment
To delete your environment, you must go in the
Danger zone and delete your Environment.