You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: umbraco-cloud/product-upgrades/manual-upgrades/README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,13 +6,13 @@ description: >-
6
6
7
7
# Upgrade your projects manually
8
8
9
-
In some cases, you might need to upgrade your Umbraco Cloud project manually. It's very similar to how you would upgrade any other Umbraco project but includes a few extra and **very important** steps.
9
+
In some cases, you might need to upgrade your Umbraco Cloud project manually. It's similar to how you would upgrade any other Umbraco project but includes a few extra and **very important** steps.
10
10
11
11
Umbraco Cloud project uses Umbraco Forms and Umbraco Deploy, which means there are also some dependencies you need to consider when upgrading your Umbraco Cloud project manually.
12
12
13
13
## Why and when would you do a manual upgrade?
14
14
15
-
By default, all Umbraco Cloud projects are automatically upgraded when we release new patches (e.g. 8.8.**1**) to the Umbraco CMS as well as Umbraco Forms and Umbraco Deploy. When we release a new _minor_ version (e.g 8.**8**) the upgrade is applied to the Umbraco Cloud engine, and **not to the individual projects** - the same goes for the release of new _major_ versions (e.g. **10**.0). For these minor and major versions, there will be an option on your Umbraco Cloud Development environment to apply the upgrade. The Umbraco Cloud engine will take care of the entire process, and you only need to make sure everything works after the upgrade has been applied.
15
+
By default, all Umbraco Cloud projects are automatically upgraded when we release new patches (e.g. 8.8.**1**) to the Umbraco CMS as well as Umbraco Forms and Umbraco Deploy. When we release a new _minor_ version (e.g 8.**8**) the upgrade is applied to the Umbraco Cloud engine, and **not to the individual projects** - the same goes for the release of new _major_ versions (e.g. **10**.0). For these minor and major versions, there will be an option on your left-most mainline environment to apply the upgrade. The Umbraco Cloud engine will take care of the entire process, and you only need to make sure everything works after the upgrade has been applied.
16
16
17
17
We always recommend using the automatic and _semi-automatic_ upgrade options provided to you as part of your Umbraco Cloud project. With that said, it's also possible to upgrade your Umbraco Cloud project manually - this can be done with both patches and minor and major versions.
Copy file name to clipboardExpand all lines: umbraco-cloud/product-upgrades/manual-upgrades/manual-cms-upgrade.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ This article will give you a step-by-step on how to manually upgrade your Umbrac
14
14
15
15
## Prepare for the upgrade
16
16
17
-
* When upgrading a Umbraco Cloud project manually, the very first step is to either [clone down your Cloud Development environment to your local machine](../../set-up/working-locally.md) or pull down the latest changes for your development environment.
17
+
* When upgrading a Umbraco Cloud project manually, the very first step is to either [clone down left-most mainline environment to your local machine](../../set-up/working-locally.md) or pull down the latest changes for your left-most mainline environment.
18
18
* Navigate to the `/src/UmbracoProject/` folder to find the `.csproj` file.
19
19
* Make sure you can run your Cloud project locally and restore content and media. It's important that you check that everything works once the upgrade has been applied and for this, you need to have a clone locally that resembles the Cloud environment as much as possible.
20
20
@@ -203,7 +203,7 @@ When you've upgraded everything locally, and made sure that everything runs with
203
203
* Stage and commit all changes in Git
204
204
* Push the changes to the Cloud environment
205
205
* When everything is pushed, head on over to the Umbraco Cloud Portal
206
-
* Access the backoffice of the Cloud environment you pushed the upgrade to - Development or Live
206
+
* Access the backoffice of the Cloud environment you pushed the upgrade
207
207
* You will again be prompted to log in to complete the database upgrade
208
208
* You will be sent to the backoffice once the upgrade is complete
Copy file name to clipboardExpand all lines: umbraco-cloud/product-upgrades/version-specific-upgrades/migrate-from-8-to-latest.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,15 +21,15 @@ You also need to make sure that the packages that you are using are available on
21
21
## Prerequisites
22
22
23
23
* A Umbraco 8 Cloud project running **the latest version of Umbraco 8**.
24
-
* A clean Cloud project running the latest version of Umbraco with **at least 2 environments**.
24
+
* A clean Cloud project running the latest version of Umbraco with **at least two environments**.
25
25
* A backup of your Umbraco 8 project database.
26
26
27
-
We strongly recommend having at least **2 environments** on the new Umbraco project.
27
+
We strongly recommend having at least **two environments** on the new Umbraco project.
28
28
29
29
{% hint style="info" %}
30
30
If your Umbraco 8 site is using Umbraco Forms, make sure to configure it to store data in the database, before beginning this tutorial [Follow the guide for migrating Umbraco Forms data to the database.](https://docs.umbraco.com/umbraco-forms/developer/forms-in-the-database)
31
31
32
-
Should something fail during the migration, the Development environment can be removed and re-added to start over on a clean slate.
32
+
Should something fail during the migration, the left-most environment can be removed and re-added to start over on a clean slate.
33
33
{% endhint %}
34
34
35
35
## Video Tutorial
@@ -47,7 +47,7 @@ If you use Umbraco Forms, make sure to have [`StoreUmbracoFormsInDbset`](https:/
47
47
1. Create a backup of the database from your Umbraco 8 project using the [database backup guide](../../databases/backups.md).
48
48
* Alternatively, you can clone the environment down and take a backup of the local Database after restoring. Make sure to restore both content and media from your Cloud environment after cloning it down.
49
49
2. Import the database backup into SQL Server Management Studio.
50
-
3. Clone down the **Development** environment from the **new** Cloud project.
50
+
3. Clone down the **left-most** mainline environment from the **new** Cloud project.
51
51
4. Test the project and make sure to log in to the backoffice.
52
52
53
53
{% hint style="info" %}
@@ -122,31 +122,31 @@ Depending on the extent of the project and the amount of custom code and impleme
122
122
123
123
## Step 4: Deploy and Test on Umbraco Cloud
124
124
125
-
Once the new Cloud project runs without errors on the local setup, the next step is to deploy and test on the Cloud **Development** environment.
125
+
Once the new Cloud project runs without errors on the local setup, the next step is to deploy and test on the Cloud **left-most** mainline environment.
126
126
127
-
1. Push the migration and changes to the Umbraco Cloud **Development** environment.
127
+
1. Push the migration and changes to the Umbraco Cloud **left-most** mainline environment.
128
128
129
129
{% hint style="info" %}
130
130
The deployment might take a bit longer than normal as a lot of changes have been made.
131
131
{% endhint %}
132
132
133
-
2. Go to the backoffice of the **Development** environment once everything has been pushed.
133
+
2. Go to the backoffice of the **left-most** mainline environment once everything has been pushed.
134
134
3. Go to **Settings** and open the **Deploy** Dashboard.
135
135
4. Click on `Export Schema to Data Files` in the **Deploy Operations** section.
136
136
* The deployment will result in either of the two:
137
137
*`Last deployment operation failed` - something failed during the check.
138
138
* Select `Clear Signatures` from the **Deploy Operations** section.
139
139
* Select `Update Umbraco Schema` from the **Deploy Operations** section to clear up the error.
140
140
*`Last deployment operation completed`
141
-
* Everything checks out: The Development environment has been upgraded.
142
-
5. Transfer Content and Media from the local clone to the **Development** environment.
141
+
* Everything checks out: The left-most environment has been upgraded.
142
+
5. Transfer Content and Media from the local clone to the **left-most** mainline environment.
143
143
* To transfer members make sure that the following Deploy settings are configured in the `appsettings.json`: [`AllowMembersDeploymentOperations` and `TransferMemberGroupsAsContent`](https://docs.umbraco.com/umbraco-deploy/deploy-settings#allowmembersdeploymentoperations-and-transfermembergroupsascontent).
144
-
6. Test **everything** in the **Development** environment.
144
+
6. Test **everything** in the **left-most** mainline environment.
145
145
7. Deploy to the **Live** environment.
146
146
147
147
## Step 5: Going live
148
148
149
-
1. Test **everything** in the **Development** environment until it runs without any errors.
149
+
1. Test **everything** in the **left-most** mainline environment until it runs without any errors.
150
150
2. Setup rewrites on the new Cloud project if relevant.
Copy file name to clipboardExpand all lines: umbraco-cloud/set-up/config-transforms.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,15 +26,15 @@ If you want to do a transform on your `Web.config` file for the Live environment
26
26
27
27
`Web.Production.config`
28
28
29
-
The `{environment}` part needs to be replaced with the target environment, for which there are currently 3 possibilities for each project:
29
+
The `{environment}` part needs to be replaced with the target environment, for which there are currently three possibilities for each project:
30
30
31
31
1.`Production`
32
32
2.`Staging`
33
33
3.`Development`
34
34
35
35
This file needs to be created on a local clone of your project, as this will ensure that the file is added to the project repository.
36
36
37
-
When the file is deployed to the Live environment, the transforms will be applied to the `Web.config` file in the `Root` of your project. In the case that you also have a Development and/or Staging environment, the `Web.Production.config` will **only** transform the `Web.config` on the Live environment.
37
+
When the file is deployed to the Live environment, the transforms will be applied to the `Web.config` file in the `Root` of your project. In the case that you have mutliple mainline environments, the `Web.Production.config` will **only** transform the `Web.config` on the Live environment.
38
38
39
39
For each deployment, the Umbraco Cloud engine searches for all of the `.{environment}.config` files in your site and apply the transforms.
40
40
@@ -60,7 +60,7 @@ Using the tool will let you test whether the transform file transforms your conf
60
60
61
61
## Examples
62
62
63
-
Rewrite rules are often something you only want to apply to your Live environment. To avoid the rewrites being applied to your Development and/or Staging environments, you can create a transform file to apply the rewrite rules to your Live environment only.
63
+
Rewrite rules are often something you only want to apply to your Live environment. To avoid the rewrites being applied to other mainline environments, you can create a transform file to apply the rewrite rules to your Live environment only.
64
64
65
65
Here is an example of how that config transform would look:
0 commit comments