Skip to content

Commit 65645a5

Browse files
Sofie Toft Kristensengitbook-bot
Sofie Toft Kristensen
authored andcommitted
GITBOOK-90: No subject
1 parent a5cc3cb commit 65645a5

File tree

15 files changed

+92
-164
lines changed

15 files changed

+92
-164
lines changed

umbraco-cloud/SUMMARY.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,7 @@
1414
* [Sustainability Dashboard](getting-started/the-umbraco-cloud-portal/sustainability-dashboard.md)
1515
* [Project Overview](getting-started/project-overview.md)
1616
* [Environments](getting-started/environments.md)
17-
* [Flexible Environments (beta)](getting-started/flexible-environments/README.md)
18-
* [Docs Strategy incl. notes](getting-started/flexible-environments/docs-strategy-incl.-notes.md)
17+
* [Flexible Environments (beta)](getting-started/flexible-environments.md)
1918
* [Baselines](getting-started/baselines/README.md)
2019
* [Baseline Merge Conflicts](getting-started/baselines/baseline-merge-conflicts.md)
2120
* [Break Reference between Baseline and Child Project](getting-started/baselines/break-baseline.md)

umbraco-cloud/deployment/README.md

-3
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,3 @@ The `name` attribute in the `umbraco-cloud.json` can be updated to clarify deplo
8080

8181
***
8282

83-
84-
85-
{% include "../.gitbook/includes/umbraco-training-cloud.md" %}
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
21
# Baseline Merge Conflicts
32

43
Here we outline how to manually resolve a merge conflict after having updated the children for a Baseline project.
@@ -7,13 +6,13 @@ On a Baseline project you can click to _“Manage updates here”_, which enable
76

87
![Upgrades Baseline children](images/manage-baseline-children.gif)
98

10-
Select the child projects you want to upgrade, and click **Update selected children**.
11-
The overview will then change to show the progress and status for updating the various child projects.
9+
Select the child projects you want to upgrade, and click **Update selected children**. The overview will then change to show the progress and status for updating the various child projects.
1210

1311
The outcome of the update will result in one of three statuses:
14-
- Updated has completed
15-
- Error while updating from upstream
16-
- Encountered a merge conflict so abandoning update
12+
13+
* Updated has completed
14+
* Error while updating from upstream
15+
* Encountered a merge conflict so abandoning update
1716

1817
A merge conflict is something you currently need to handle manually in order to push future updates to the child project, which encountered a merge conflict upon updating.
1918

@@ -23,44 +22,47 @@ A merge conflict is something you currently need to handle manually in order to
2322

2423
**Note:** Since the following documentation was outlined we've made quite a few improvements to the Baseline workflow. For the most part this documentation is still relevant and we are working on getting them updated with the latest details.
2524

26-
In order to resolve the conflict you need to go to the **child site** open up the SCM / Kudu site for the development environment. Click the “[link]” (see screenshot above) for the project (see screenshot above) and find clone url for the development site, which is similar to this: `https://dev-my-website-alias.scm.umbraco.io/c565ead8-7a27-4696-9ab4-dad7eba2cd2c.git` and remove everything after the last slash, so you have a url that looks like this: `https://dev-my-website-alias.scm.umbraco.io`
25+
In order to resolve the conflict you need to go to the **child site** open up the SCM / Kudu site for the development environment. Click the “\[link]” (see screenshot above) for the project (see screenshot above) and find clone url for the development site, which is similar to this: `https://dev-my-website-alias.scm.umbraco.io/c565ead8-7a27-4696-9ab4-dad7eba2cd2c.git` and remove everything after the last slash, so you have a url that looks like this: `https://dev-my-website-alias.scm.umbraco.io`
2726

2827
![environment](images/getcloneurl.jpg)
2928

30-
You will be prompted to login to the SCM / Kudu site - use the credentials you normally use to login to the Umbraco Cloud portal.
31-
Now click “Debug console” from the top menu and select “CMD”. This will take you to a command line interface from where you need to navigate to the repository folder: site / repository
29+
You will be prompted to login to the SCM / Kudu site - use the credentials you normally use to login to the Umbraco Cloud portal. Now click “Debug console” from the top menu and select “CMD”. This will take you to a command line interface from where you need to navigate to the repository folder: site / repository
3230

3331
![environment](images/image03.png)
3432

35-
From here you need to merge the branch (upstream/master), which contains the updates which were fetched from the Baseline project.
36-
In the console enter:
37-
`git merge upstream/master`
33+
From here you need to merge the branch (upstream/master), which contains the updates which were fetched from the Baseline project. In the console enter: `git merge upstream/master`
3834

3935
This will result in an output showing the files, which contains conflicts that you need to resolve in order to fully merge the two branches:
4036

41-
Auto-merging data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
42-
CONFLICT (content): Merge conflict in data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
43-
Auto-merging data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
44-
CONFLICT (content): Merge conflict in data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
45-
Automatic merge failed; fix conflicts and then commit the result.
37+
```
38+
Auto-merging data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
39+
CONFLICT (content): Merge conflict in data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
40+
Auto-merging data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
41+
CONFLICT (content): Merge conflict in data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
42+
Automatic merge failed; fix conflicts and then commit the result.
43+
```
4644

4745
In the above output two files are listed and we want to pick the ones that comes from the current project (the child) - in other words we want to keep our files, as these are content changes. We use the following commands to achieve that:
4846

49-
git checkout --ours data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
47+
```
48+
git checkout --ours data/Revision/properties/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
5049
51-
git checkout --ours data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
50+
git checkout --ours data/Revision/documents/77279e39-ed1f-428a-ad7e-258db5f9e6ee.courier
51+
```
5252

5353
_Note_: If you wanted to select the files from the Baseline project instead of the ones from the current project, you should write “--theirs” instead of “--ours” in the command from above. “Ours” corresponds to the current project (the development site) and “Theirs” corresponds to the Baseline project.
5454

5555
Now you need to add the (modified) files to Git and finally commit the changes using the following commands:
5656

57-
git add .
58-
git commit -m “Resolving merge conflicts”
57+
```
58+
git add .
59+
git commit -m “Resolving merge conflicts”
60+
```
5961

60-
The merge conflict has now been resolved, and you can update your local repository with the latest changes by pulling from the development site.
61-
Please note that the changes from the commit haven’t been deployed to the website yet, as we have only applied the changes to the Git repository. In order to deploy the recent changes to the website you can push your local changes to the development site or you can use the Kudu api to trigger a deployment.
62-
You can use the following command from the Kudu Debug Console to deploy the latest changes:
62+
The merge conflict has now been resolved, and you can update your local repository with the latest changes by pulling from the development site. Please note that the changes from the commit haven’t been deployed to the website yet, as we have only applied the changes to the Git repository. In order to deploy the recent changes to the website you can push your local changes to the development site or you can use the Kudu api to trigger a deployment. You can use the following command from the Kudu Debug Console to deploy the latest changes:
6363

64-
curl https://dev-my-website-alias.scm.s1.umbraco.io/api/deployments -X PUT -H "Content-Type: Application/json" --data "{ }" --user yourusername:password
64+
```
65+
curl https://dev-my-website-alias.scm.s1.umbraco.io/api/deployments -X PUT -H "Content-Type: Application/json" --data "{ }" --user yourusername:password
66+
```
6567

6668
If you prefer to use the Kudu REST API for triggering a deployment, you can find the details here: [https://github.com/projectkudu/kudu/wiki/REST-API#deployment](https://github.com/projectkudu/kudu/wiki/REST-API#deployment)

umbraco-cloud/getting-started/flexible-environments/README.md renamed to umbraco-cloud/getting-started/flexible-environments.md

-20
Original file line numberDiff line numberDiff line change
@@ -30,23 +30,3 @@ This feature enables:
3030
* **Easier hotfixes and feature releases**: Urgent fixes can be deployed directly without being blocked by unfinished work in other environments.
3131

3232
Improved Content Management: Content editors can create, test, and validate content changes without depending on the Development environment.
33-
34-
***
35-
36-
## On this page:
37-
38-
### Key concepts (??)
39-
40-
## Plan/Availability
41-
42-
This should be added on Umbraco.com, and not be part of the documentation. We can always link to Umbraco.com.
43-
44-
We should at least not be adding information about pricing - this is not relevant for documentation.
45-
46-
## How to deploy between your flexible environment and the mainline environment
47-
48-
This is a guide and should contain information about both directions.
49-
50-
## Creating a new mainline/flexible environment
51-
52-
These should eventually replace the other articles we have about creating environments.

umbraco-cloud/getting-started/flexible-environments/docs-strategy-incl.-notes.md

-41
This file was deleted.

umbraco-cloud/getting-started/migrate-between-regions.md

+7-8
Original file line numberDiff line numberDiff line change
@@ -109,24 +109,23 @@ Use the following AzCopy command to transfer the media files from the **West EU*
109109

110110
`azcopy copy "<West-EU-SAS-URL>" "<East-US-SAS-URL>" --recursive`
111111

112-
- Replace `<West-EU-SAS-URL>` with the SAS URL of the **West EU** blob storage container.
113-
- Replace `<East-US-SAS-URL>` with the SAS URL of the **East US** blob storage container.
114-
- The `--recursive` flag ensures that all files and subfolders are copied.
112+
* Replace `<West-EU-SAS-URL>` with the SAS URL of the **West EU** blob storage container.
113+
* Replace `<East-US-SAS-URL>` with the SAS URL of the **East US** blob storage container.
114+
* The `--recursive` flag ensures that all files and subfolders are copied.
115115

116116
#### Verify the File Transfer
117117

118-
1. Verify the files in the **East US** container using AzCopy:
119-
`azcopy list "<East-US-SAS-URL>"`
118+
1. Verify the files in the **East US** container using AzCopy: `azcopy list "<East-US-SAS-URL>"`
120119
2. Check that all expected media files have been successfully transferred.
121120
3. Reload the front end and backoffice of the **East US** project to confirm the images are displayed correctly.
122121

123122
The migration process is complete when the media files have been migrated to the **East US** environment.
124123

125124
{% hint style="info" %}
126-
**Recommendation**
127-
It is highly recommended that the migrated site be thoroughly reviewed to ensure all media items function as expected.
125+
**Recommendation** It is highly recommended that the migrated site be thoroughly reviewed to ensure all media items function as expected.
128126
{% endhint %}
129-
## Post-migration tasks
127+
128+
\## Post-migration tasks
130129

131130
Following the steps above you have migrated your Umbraco project from one Cloud environment to another.
132131

umbraco-cloud/getting-started/the-umbraco-cloud-portal/sustainability-dashboard.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# Sustainability dashboard
1+
# Sustainability Dashboard
22

33
The Sustainability Dashboard is designed to help users monitor and improve the environmental impact of their websites on Umbraco Cloud. The dashboard provides insights and metrics related to carbon footprint and sustainable practices, enabling organizations to align their digital presence with their sustainability goals.
44

55
## Key Features
66

7-
- **Daily CO2 emission calculation**: The dashboard is updated daily with new CO2 emission estimates.
8-
- **Historical data**: The dashboard tracks monthly and yearly CO2 emission estimates, allowing for trend analysis over time
9-
- **Comparative analysis**: Users can compare CO2 emissions across their projects to identify high-impact areas and improvement opportunities.
7+
* **Daily CO2 emission calculation**: The dashboard is updated daily with new CO2 emission estimates.
8+
* **Historical data**: The dashboard tracks monthly and yearly CO2 emission estimates, allowing for trend analysis over time
9+
* **Comparative analysis**: Users can compare CO2 emissions across their projects to identify high-impact areas and improvement opportunities.
1010

1111
## CO2 emission calculation methodology
1212

@@ -25,7 +25,7 @@ Environment CO2 emissions = Total CO2 emissions of backend compute infrastructur
2525

2626
### Cloud Carbon Footprint
2727

28-
Cloud Carbon Footprint(CCF) provides a comprehensive methodology for estimating CO2 emissions in their [documentation](https://www.cloudcarbonfootprint.org/docs/methodology/). We use CCF to calculate the Sum of environmental CO2 emissions.
28+
Cloud Carbon Footprint(CCF) provides a comprehensive methodology for estimating CO2 emissions in their [documentation](https://www.cloudcarbonfootprint.org/docs/methodology/). We use CCF to calculate the Sum of environmental CO2 emissions.
2929

3030
```math
3131
CCF CO2 emissions = Operational emissions + Embodied emissions
@@ -41,18 +41,18 @@ Embodied emissions = Estimated metric tons CO2 emissions from the manufacturing
4141
For websites on shared infrastructure in Umbraco Cloud, we calculate a usage coefficient to improve the accuracy of CO2 emission estimates. This coefficient divides the CO2 emissions of the shared pool among the websites using it.
4242

4343
The usage coefficient for a website is based on metrics such as:
44+
4445
* CPU
4546
* Memory usage
4647

47-
The usage coefficient for a database is based on DTUs used etc.
48+
The usage coefficient for a database is based on DTUs used etc.
4849

4950
```math
5051
Website CO2 emissions = Usage coefficient * CCF CO2 emissions
5152
Usage coefficient = Website resource usage / Total pool usage
5253
```
5354

54-
**Website Resource Usage**: For compute resources we evaluate metrics such as CPU, memory or disk, for storage resources DTUs and disk are considered.
55-
**Total Pool Usage**: The total resource usage of the shared pool of resources.
55+
**Website Resource Usage**: For compute resources we evaluate metrics such as CPU, memory or disk, for storage resources DTUs and disk are considered. **Total Pool Usage**: The total resource usage of the shared pool of resources.
5656

5757
## Getting Started
5858

umbraco-cloud/set-up/going-live.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,8 @@ Working with Umbraco Forms, allows you to set up email workflows that enable you
1515
When you create a project on Umbraco Cloud, the generated project URL is based on the project's name and that might not be the preferred URL for your website. Therefore, you have the option to add your hostname.
1616

1717
{% hint style="info" %}
18-
Before adding a hostname, you need to update your DNS host domain registrar DNS entries to resolve to `umbraco.io`. We recommend setting a CNAME record for your site using the `dns.umbraco.io` Umbraco Cloud DNS record.
19-
You can read more about how to do this under [Manage Hostnames](project-settings/manage-hostnames/).
20-
{% endhint %}
18+
Before adding a hostname, you need to update your DNS host domain registrar DNS entries to resolve to `umbraco.io`. We recommend setting a CNAME record for your site using the `dns.umbraco.io` Umbraco Cloud DNS record. You can read more about how to do this under [Manage Hostnames](project-settings/manage-hostnames/).
19+
{% endhint %}
2120

2221
## [Deploy to Live](../deployment/cloud-to-cloud.md)
2322

umbraco-cloud/set-up/project-settings/README.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -87,14 +87,13 @@ The Connections section provides connection details for your Umbraco Cloud datab
8787

8888
The Automatic Upgrades section handles minor and patch upgrades for the Umbraco components used by Umbraco Cloud. By default, new projects are opt-in for these upgrades.
8989

90-
From this page, you can manage whether your site is automatically upgraded to the latest minor version(s) of the Cloud products. To learn more about automatic upgrades, visit the [Upgrades](../../product-upgrades/README.md) section.
90+
From this page, you can manage whether your site is automatically upgraded to the latest minor version(s) of the Cloud products. To learn more about automatic upgrades, visit the [Upgrades](../../product-upgrades/) section.
9191

9292
![Automatic Upgrades](../images/automatic-upgrades.png)
9393

9494
### [CDN & Caching](manage-cdn-caching.md)
9595

96-
The CDN & Caching section lets you manage CDN Caching and Optimization settings for your project.
97-
You can:
96+
The CDN & Caching section lets you manage CDN Caching and Optimization settings for your project. You can:
9897

9998
* Modify the default settings that apply to all hostnames added to the project.
10099
* Set specific caching settings per hostname if different configurations are required for certain hostnames.

umbraco-cloud/set-up/project-settings/external-services.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -18,25 +18,28 @@ The enabling of static outbound IP addresses will have the effect that port 25 w
1818

1919
![StaticOutboundIps](https://user-images.githubusercontent.com/93588665/158338313-c433c994-71a5-40f5-a947-4947df23a0cf.gif)
2020

21-
The static outbound IP ranges vary per region.
22-
Below are the values per region in a [CIDR](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) (Classless Inter-Domain Routing) notation. The expanded IP ranges can be calculated by using [online tooling](https://www.ipaddressguide.com/cidr).
21+
The static outbound IP ranges vary per region. Below are the values per region in a [CIDR](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) (Classless Inter-Domain Routing) notation. The expanded IP ranges can be calculated by using [online tooling](https://www.ipaddressguide.com/cidr).
2322

2423
**West Europe**
24+
2525
```cs
2626
40.113.173.32/28
2727
```
2828

2929
**UK South**
30+
3031
```cs
3132
20.90.182.0/28
3233
```
3334

3435
**US East**
36+
3537
```cs
3638
20.55.62.0/28
3739
```
3840

3941
**Australia East**
42+
4043
```cs
4144
4.147.161.240/28
4245
```

0 commit comments

Comments
 (0)