-
Notifications
You must be signed in to change notification settings - Fork 811
Updated Migrating regions cloud article to use new backup feature and import/export features on cloud and deploy. #6394
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 3 commits
b41a378
2b37f86
f5a5136
b8e945a
f8cfaf3
5c30730
06bda3e
fb989be
f9e59b9
7b6ffb1
6d9c99f
9c37c1a
af8f984
6f33c63
f53bfe0
ca294bf
b524b9e
63b88e4
0e1131f
8d34823
cb89194
6c873d6
f2ca3c6
fe4d036
de59d54
be63eb8
5a1a204
5e12826
157357e
b972157
1cfa53a
9346b0a
df0d6b9
904940b
b45181b
65b6e95
5813d64
fd1f784
838c3bd
ea02cab
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -6,7 +6,7 @@ | |||||
|
||||||
# Migrate between regions | ||||||
|
||||||
When creating a project on Umbraco Cloud, you can choose to host the project in different regions: East US, EU West, South UK, or East Australia. | ||||||
Creating a project on Umbraco Cloud, you can choose to host the project in different regions: East US, West EU, South UK, or East Australia. | ||||||
|
||||||
In some cases, you might want to migrate your project(s) from one region to another. This article will outline the steps to do this. | ||||||
|
||||||
|
@@ -15,11 +15,11 @@ | |||||
## Prerequisites | ||||||
|
||||||
* Admin access and deployment rights on the project that is to be migrated. | ||||||
* Git is installed locally as well as a Git client like _Git Bash_. | ||||||
* A clone of both East US and West EU projects. | ||||||
* A local setup that can run an Umbraco instance. Learn more about this in the [Requirements](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/requirements) article. | ||||||
|
||||||
{% hint style="info" %} | ||||||
To follow this guide, it is highly recommended that you have experience with Git and running git commands through a command line tool. | ||||||
If you want to migrate a Umbraco 8 project, you will need to upgrade to the latest supported [Long-Term-Supported (LTS)](https://umbraco.com/products/knowledge-center/long-term-support-and-end-of-life/) version of Umbraco CMS. | ||||||
{% endhint %} | ||||||
|
||||||
## Prepare your projects | ||||||
|
@@ -42,81 +42,70 @@ | |||||
Make sure that your projects are [prepared for migration](migrate-between-regions.md#prepare-your-projects) before continuing the process. | ||||||
{% endhint %} | ||||||
|
||||||
{% tabs %} | ||||||
{% tab title="Umbraco 10+" %} | ||||||
1. Clone down the project that you want to migrate - the _EU project_. | ||||||
2. Restore content and media through the Umbraco backoffice. | ||||||
3. Clone down the new Cloud project created in the US region - the _US project_. | ||||||
4. Replace the `src/UmbracoProject/umbraco-cloud.json` file in the _EU project_ with the one from the _US project_. | ||||||
|
||||||
{% hint style="info" %} | ||||||
The `umbraco-cloud.json` file contains details about each environment on the Cloud project. | ||||||
|
||||||
By replacing the one on the _EU project_ with the one from the _US project_, content, and media transfers will point to the environments on the _US project_ instead of the _EU project_. | ||||||
{% endhint %} | ||||||
|
||||||
5. Commit the change through git, but do not push it yet. | ||||||
6. Use the following git commands to connect your local _EU project_ to the live environment on the _US project_: | ||||||
### Step 1: Creating and restore database backup | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
``` | ||||||
git remote rm origin | ||||||
git remote add origin https://scm.umbraco.io/useast01/name-of-us-live-site.git | ||||||
git fetch | ||||||
git branch --set-upstream-to=origin/master | ||||||
``` | ||||||
{% tab title="Umbraco 10+" %} | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
1. Go to **Configuration** > **Backups** on the **West EU** Cloud project. | ||||||
2. Create a **backup** of the projects database. | ||||||
3. Download the backup to your local machine. | ||||||
4. Go to the **East US** project. | ||||||
5. Go to **Configuration** > **Backups**. | ||||||
6. Upload the **database backup** that you created in the previous step to the project. | ||||||
7. Restore the **backup** to your environment | ||||||
- **Optional** Create a backup of the environment before restoring the backup. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
8. Run a **Export Schema** and then **Update Umbraco Schema** from the **Deploy Dashboard** in the settings section of the **East US** project. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
7. Push the schema and files from the _EU project_ to the _US project_ using the following git command: | ||||||
Once you have restored the database to your environment, go to the backoffice of the project you are migrating to. In the backoffice, you should now see your content in the content section, and Document Types and Data Types in the settings section. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
``` | ||||||
git push origin master -f | ||||||
``` | ||||||
|
||||||
8. Verify that the schema and files have been merged into the live environment on the _US project_. | ||||||
9. Transfer content and media from the local _EU project_ to the _US project_. | ||||||
10. Verify that all the content and media have been transferred to the _US project_. | ||||||
{% endtab %} | ||||||
Taking a closer look at the templates, stylesheets, scripts media, you will notice that it is not there. In the next step we will migrate those over to our new project | ||||||
|
||||||
{% tab title="Umbraco 8" %} | ||||||
1. Clone down the project that you want to migrate - the _EU project_. | ||||||
2. Restore content and media through the Umbraco backoffice. | ||||||
3. Clone down the new Cloud project created in the US region - the _US project_. | ||||||
4. Replace the `Config/UmbracoDeploy.config` file in the _EU project_ with the one from the _US project_. | ||||||
|
||||||
{% hint style="info" %} | ||||||
The `UmbracoDeploy.config` file contains details about each environment on the Cloud project. | ||||||
### step 2: Migrate files | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
By replacing the one on the _EU project_ with the one from the _US project_, content, and media transfers will point to the environments on the _US project_ instead of the _EU project_. | ||||||
{% endhint %} | ||||||
In this step, we will migrate our files and media items from our project on the EU region. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
5. Commit the change through git, but do not push it yet. | ||||||
6. Use the following git commands to connect your local _EU project_ to the live environment on the _US project_: | ||||||
1. Clone down both project to your local machine. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
2. Run the local East US project and restore the content. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
3. Open project folders from both **West EU** and **East US**. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
4. Move the view files located in the view folder from **West EU** to the view folder in the **East US** project. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
- When promted replace the existing files. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
5. Move the CSS and Script files located in the wwwroot folder from the **West EU** folder to the wwwroot folder in the **East US** project. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
6. **Optional:** Move files from App_Plugins if you have extended the Umbraco Backoffice | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
7. Run the **East US** project locally. | ||||||
|
||||||
``` | ||||||
git remote rm origin | ||||||
Once you have started the project up, the project should show your content as it was on the **West EU** project. The only thing missing will be the media items, as they have not been migrated over yet. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
git remote add origin https://scm.umbraco.io/useast01/name-of-us-live-site.git | ||||||
### Step 3: Migrate Media Items | ||||||
|
||||||
git fetch | ||||||
In the following step we will migrate our media items from our **West EU** project to our **East US** project. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
git branch --set-upstream-to=origin/master | ||||||
``` | ||||||
1. Run the **West EU** on your local machine | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
2. Go to the media section on the **West EU** project. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
3. Click on the 3 dots in the top of the media section. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
4. Click **Export** in the side-menu. | ||||||
5. Click the button to export the media items located in the media section. | ||||||
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
6. Click **Download** to download the zip file with the media items to your local machine. | ||||||
7. Run the **East US** project on your local machine. | ||||||
8. Navigate to the media section. | ||||||
|
8. Navigate to the media section. | |
8. Navigate to the **Media** section. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In step 2 it is written as: Go to the Media section of the West EU project. Maybe you can have the same sentence for both steps to maintain consistency.
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
jonat123 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
Check warning on line 108 in umbraco-cloud/getting-started/migrate-between-regions.md
GitHub Actions / runner / vale
[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).
Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "umbraco-cloud/getting-started/migrate-between-regions.md", "range": {"start": {"line": 108, "column": 1}}}, "severity": "WARNING"}
Uh oh!
There was an error while loading. Please reload this page.