Environment
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
production
,main
ormaster
,staging
,dev
,fix/xxx
,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.
Deployment Management
Have a look at the Deployment Management section for more information.
Deployment rules and automatic option.
By default, mode
and cluster
parameters are set as "automatic".
If 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 mode
and 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 SETTINGS
button.
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.
Preview 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.
Clone environment
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 Preview
.
Advanced features
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
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
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.
Deployment rules
The Deployment Rules lets you configure the lifecycle of your Environments.
Refer to the Deployment Rule documentation to know more.
Deployments history
You can easily access to the deployments history of your environment by clicking on deployment history button
in Action
menu.
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 settings
> Danger zone
and delete your Environment.