Skip to content

Commit 8e77102

Browse files
committed
Update Environments article
1 parent 29db9eb commit 8e77102

File tree

1 file changed

+48
-24
lines changed

1 file changed

+48
-24
lines changed
Lines changed: 48 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,71 @@
11
# Environments
22

3-
## What is an environment?
3+
An Umbraco Cloud environment is defined as a _workspace_ and is at the same time a Git repository. When you have more than one environment on your project, these environments will act as branches of the main repository.
44

5-
An environment on an Umbraco Cloud project can be defined as a _workspace_ and is at the same time a Git repository. When you have more than one environment on your project, these environments will act as branches of the main repository.
5+
Umbraco Cloud uses a deployment model that relies on Git and other core technology. This gives you the option to move both content and structure files from one environment to another. Learn more in the [Deployment section](../deployment/README.md).
66

7-
Umbraco Cloud uses a deployment model that relies on Git and other core technology, which gives you the option to move both content and structure files from one environment to another. Learn more in the [Deployment section](../deployment/).
7+
You can have multiple environments on your Umbraco Cloud project and there are two types of environments available. These are **Mainline Environments** and **Flexible Environments**.
88

9-
When you have multiple environments in your Umbraco Cloud project:
9+
## Mainline Environments
1010

11-
* The _Development_ environment is the first environment in the workflow.
11+
A mainline environment serves as the root deployment pipeline, responsible for managing code and content flow. Each mainline environment is a part of the [left-to-right deployment workflow](../deployment/README.md).
1212

13-
This is the environment you are going to work with when building the structure of your website. This is also the environment you clone down when you want to work on your project locally.
13+
The **left-most mainline environment** is where you can connect to your local machine using Git. This environment is often called the Development environment.
1414

15-
The Development environment is included in the Standard and Professional plans on Umbraco Cloud. In the Starter plan, you have the option to add the Development environment.
16-
* The environment next in line in the workflow is the _Staging_ environment.
15+
The **right-most mainline environment** is your live website, often called the Live or Production environment.
1716

18-
This environment enables you to give your team members different workspaces - the developers can work with code in the Development environment while content editors can work with content in the Staging environment. All of this without affecting the actual public site.
17+
Each mainline environment can have one or more flexible environments branching off from it.
1918

20-
The Staging environment is included in the Professional plan. In the Standard plan, you have the option to add the Staging environment.
19+
## Flexible Environments
2120

22-
{% hint style="info" %}
23-
Both the Development and the Staging environments are protected with **basic authentication**. This means that you must log in to see the frontend of these environments.
24-
{% endhint %}
21+
A flexible environment is an environment that branches off a mainline environment. It is positioned vertically from the mainline deployment flow.
2522

26-
* The final environment is the _Live_ environment.
23+
Changes made on a flexible environment can only be pushed to the next designated Mainline Environment in the pipeline.
2724

28-
This is your live site - the site that's visible to the public. When you are in trial mode the Live environment will be protected by basic authentication - this will be removed as soon as you set up a subscription for the project.
25+
Technically, the flexible environment connected only to its mainline environment using a Git remote. This ensures that changes follow a structured path while still allowing flexibility in development workflows.
2926

30-
The Live environment is included in the Standard and Professional plans on Umbraco Cloud.
27+
Learn more about how this works in the [Flexible Environments](flexible-environments.md) article.
3128

32-
For more information about the workflow on Umbraco Cloud, see the [Deployments](../deployment/) article. Below you will find a technical overview of the different parts that make up an environment on your Umbraco Cloud project:
29+
## Plans and availability
30+
31+
<table>
32+
<thead>
33+
<tr>
34+
<th width="117">Plan</th>
35+
<th width="116" data-type="number">Mainline Environments</th>
36+
<th width="167" data-type="checkbox">Flexible Environments</th>
37+
</tr>
38+
</thead>
39+
<tbody>
40+
<tr>
41+
<td>Starter</td>
42+
<td>2</td>
43+
<td>false</td>
44+
</tr>
45+
<tr>
46+
<td>Standard</td>
47+
<td>3</td>
48+
<td>true</td>
49+
</tr>
50+
<tr>
51+
<td>Professional</td>
52+
<td>4</td>
53+
<td>true</td>
54+
</tr>
55+
</tbody>
56+
</table>
3357

3458
![Umbraco Cloud Environment Technical Overview](images/environment-tech-overview.png)
3559

3660
## Site and Git Repository
3761

3862
Each environment on Umbraco Cloud has both a Git repository and a folder with your actual live site. The Git repository is what you clone down when you work with the project locally, and it's where your changes are pushed to.
3963

40-
The live site (`/site/wwwroot/`) contains the files used to show your website to the world. When you push changes from your local machine, they are pushed to the Git repository (`/site/repository/`), and when this finishes successfully the changes are copied into the live site.
64+
The live site (`/site/wwwroot/`) contains the files used to show your website to the world. When pushing changes from your local machine, they are pushed to the Git repository (`/site/repository/`). When this finish successfully the changes are copied into the live site.
4165

42-
## Team Members/Invite Users
66+
## Team Members
4367

44-
All the team members you add through the Umbraco Cloud Portal will also be added as backoffice users in your environments. As with any other Umbraco CMS installation, you can also add users directly in the backoffice of your Umbraco Cloud environments. If you do this, the user will not have the option to deploy changes between the environments.
68+
All the team members you add through the Umbraco Cloud Portal will also be added as backoffice users in your environments. You can also add users directly in the backoffice of your Umbraco Cloud environments. If you do this, the user will not have the option to deploy changes between the environments.
4569

4670
Read more about this and team member roles in the [Team Members](../set-up/project-settings/team-members/) article.
4771

@@ -53,14 +77,14 @@ Learn more about how to connect to your Umbraco Cloud databases in the [Database
5377

5478
## Power Tools (Kudu)
5579

56-
Aside from viewing the files on your Umbraco Cloud environments when cloning down the project to your local machine, you also have access to what we call **Power Tools** - Kudu.
80+
Aside from viewing the files when cloning down the project to your local machine, you also have access to Kudu (Power Tools).
5781

58-
This is a dashboard that allows you to browse, view, and edit all the files in your Umbraco Cloud environment. We recommend using the tool _only_ when you are following one of our guides in the Troubleshooting section.
82+
Kudu is a dashboard that allows you to browse, view, and edit all the files in your environments. We recommend using the tool _only_ when you are following one of our guides.
5983

6084
In the [Power Tools](../set-up/power-tools/) article, you can read more about how to access the dashboard, and how we recommend using it.
6185

6286
## Environment History
6387

64-
Each of your Umbraco Cloud environments has a Git repository and therefore also a Git history. We've made a simplified view of this Git history in the Umbraco Cloud Portal - the **Environment History**.
88+
Each of your Umbraco Cloud environments has a Git repository and therefore also a Git history. We've made a simplified view of this Git history in the Cloud Portal. The **History** is found via the action menu available on each environment in the environments overview on your project.
6589

66-
In this view, you'll be able to see what file changes have been made in each environment.
90+
In the History view, you'll be able to see what file changes have been made in the environment.

0 commit comments

Comments
 (0)