Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
55 changes: 35 additions & 20 deletions umbraco-cloud/set-up/manage-environments.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,50 @@
# Manage Environments

When working with an Umbraco Cloud project, you can add or remove extra environments depending on the plan you are in:
The number of Environments in your project is dependent on which plan you are on:

* For the Starter plan, you can add a Development environment for an additional price per month.
* For the Standard plan, you get the Development environment for free and can add a Staging environment for an additional price per month.
* For the Professional plan, you get the Development and Staging environment for free. Additionally, you can add and remove environments whenever you like without any additional cost.
<table><thead><tr><th width="117">Plan</th><th width="116" data-type="number">Environments</th><th width="167" data-type="checkbox">Flexible Environments</th><th>Environment Combinations Examples</th></tr></thead><tbody><tr><td>Starter</td><td>2</td><td>false</td><td><em>QA + Production</em></td></tr><tr><td>Standard</td><td>3</td><td>true</td><td><em>Flexible + QA + Production</em><br><em>Development + QA + Production</em></td></tr><tr><td>Professional</td><td>4</td><td>true</td><td><em>Flexible + Development + QA + Production</em></td></tr></tbody></table>

[Learn more about the additional prices on Umbraco Cloud](https://umbraco.com/cloud-pricing/).

{% embed url="https://www.youtube.com/watch?v=avzRNFR-FSY" %}
Adding an additional environment to a Cloud project
{% endembed %}
[Learn more about Umbraco Cloud Pricing](https://umbraco.com/cloud-pricing/).

## Adding or Removing Environments

**Important:** _Before_ adding an environment, you should consider if you have any changes locally that are not on Live yet. If you do, you should make sure to push it as adding another environment will also push it into the deployment chain.
### Adding an Environment

Before adding an environment, ensure there are no local changes that haven’t been pushed to Live. Adding an environment will push all changes in the current deployment chain.

To add an environment:

1. Click **Configure environments**.

![Adding an environment](images/environments-overview-new.png)

2. Click **Create environment**.

![Create environment](images/create-environment.png)

3. Choose an **Environment name**.
4. Click **Confirm**.

After adding a new left-most mainline environment or a flexible environment, you need to clone this environment instead. The current local clone will be set up to push to Live, while the fresh clone will push to the new environment.

### Removing an Environment

**Important:** _After_ adding a Development environment, you need to do a fresh clone of the site. The local version you have will be set up to push directly to Live, a fresh clone will push to Development.
To remove an environment:

You can add environments from your project overview here:
1. Navigate to the environment you want to delete.
2. Click on the three dots.
3. Click **Delete**.

<figure><img src="../.gitbook/assets/image (16).png" alt="Adding environments"><figcaption><p>Adding environments</p></figcaption></figure>
![Deleting an environment](images/delete-environment.png)

To remove an environment, go to the environment you want to delete click on the three dots, and click delete:
It may take a few minutes for Cloud to set up the changes after adding or removing an environment.

<figure><img src="../.gitbook/assets/image (17).png" alt=""><figcaption></figcaption></figure>
## Configuring Environments

{% hint style="info" %}
There is a specific order that the environments are being added. You will need to have a Development environment before you can have a Staging environment.
{% endhint %}
Clicking Configure environments from the project overview gives you access to environment management options. From here, you can:

Suppose you have both a Development and a Staging environment and need to remove the Development environment. In that case, you will first need to remove the Staging environment before you can remove the Development environment.
- Rename an existing environment.
- Create a new environment.
- Delete an environment you no longer need.

Once you have added or removed an environment, it will take a couple of minutes for Cloud to set it all up, and then you will be ready to use it.
These options help keep your deployment pipeline organized and aligned with your team's workflow.