Skip to content

Update migrate-between-regions.md #6772

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.

Sign up for GitHub

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

Merged
merged 6 commits into from
Jan 10, 2025
Merged

Update migrate-between-regions.md #6772

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
bef6060
Update migrate-between-regions.md
Welander1994 Jan 8, 2025
39437a6
Update umbraco-cloud/getting-started/migrate-between-regions.md
Welander1994 Jan 8, 2025
5f2fe72
Update umbraco-cloud/getting-started/migrate-between-regions.md
Welander1994 Jan 8, 2025
72cd502
Apply suggestions from code review
sofietoft Jan 10, 2025
ebf8c83
Update migrate-between-regions.md
sofietoft Jan 10, 2025
7315b78
Update migrate-between-regions.md
sofietoft Jan 10, 2025
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
37 changes: 28 additions & 9 deletions umbraco-cloud/getting-started/migrate-between-regions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,19 +86,38 @@ Verify that all schemas, files, and content have been successfully deployed to y

### Step 4: Migrate Media Items

In the following steps, we will migrate the media items from the **West EU** blob storage container to the **East US** blob storage container.
In the following steps, we will migrate media items from the **West EU** blob storage container to the **East US** blob storage container using **AzCopy**.

1. Follow the guide in the [Connect to Azure Storage Explorer](../set-up/azure-blob-storage/connect-to-azure-storage-explorer.md) article to access the Azure Blob Storage container connected to both the **West EU** and **East US** environment.
2. Locate the media files for the **West EU** Umbraco project.
3. Download the **West EU** media folder from the Azure Storage Explorer.
4. Go to the **East US** blob container.
5. Upload the **West EU** media folder to the **East US** blob container.
6. Reload the front end and backoffice of the **East US** project to verify that the images have been added correctly.
1. **Download the AzCopy Portable Binary**\
Download the AzCopy portable binary from the [official Microsoft AzCopy page](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10#download-azcopy).\
Extract the binary to a directory on your local machine and ensure you can run it from the command line.

When the media folder has been moved to the migrated project the migration process is complete.
2. **Locate the SAS URLs**\
Locate the **Shared Access Signature (SAS)** for the **West EU** and **East US** Umbraco projects. These can be found under **Configuration / Connection** in the Umbraco Cloud portal.\
Ensure the SAS tokens have sufficient permissions for reading from the **West EU** container and writing to the **East US** container.

It is highly recommended to thoroughly go through everything on the migrated site to ensure that everything works as expected.
3. **Copy the Media Files**\
Use the following AzCopy command to transfer the media files directly from the **West EU** container to the **East US** container:

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

- Replace `<West-EU-SAS-URL>` with the SAS URL of the **West EU** blob storage container.
- Replace `<East-US-SAS-URL>` with the SAS URL of the **East US** blob storage container.
- The `--recursive` flag ensures that all files and subfolders are copied.
4. **Verify the File Transfer**\
After the transfer, verify the files in the **East US** container using AzCopy:

`azcopy list "<East-US-SAS-URL>"`

Check that all expected media files have been successfully transferred.

5. **Reload the Project**\
Reload the front end and backoffice of the **East US** project to confirm that the images are displayed correctly.

When the media files have been migrated to the **East US** environment, the migration process is complete.
Copy link
Contributor

@sofietoft sofietoft Jan 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. **Copy the Media Files**\
Use the following AzCopy command to transfer the media files directly from the **West EU** container to the **East US** container:
`azcopy copy "<West-EU-SAS-URL>" "<East-US-SAS-URL>" --recursive`
- Replace `<West-EU-SAS-URL>` with the SAS URL of the **West EU** blob storage container.
- Replace `<East-US-SAS-URL>` with the SAS URL of the **East US** blob storage container.
- The `--recursive` flag ensures that all files and subfolders are copied.
4. **Verify the File Transfer**\
After the transfer, verify the files in the **East US** container using AzCopy:
`azcopy list "<East-US-SAS-URL>"`
Check that all expected media files have been successfully transferred.
5. **Reload the Project**\
Reload the front end and backoffice of the **East US** project to confirm that the images are displayed correctly.
When the media files have been migrated to the **East US** environment, the migration process is complete.
#### Copy the Media Files
Use the following AzCopy command to transfer the media files from the **West EU** container to the **East US** container:
`azcopy copy "<West-EU-SAS-URL>" "<East-US-SAS-URL>" --recursive`
- Replace `<West-EU-SAS-URL>` with the SAS URL of the **West EU** blob storage container.
- Replace `<East-US-SAS-URL>` with the SAS URL of the **East US** blob storage container.
- The `--recursive` flag ensures that all files and subfolders are copied.
#### Verify the File Transfer
1. verify the files in the **East US** container using AzCopy:
`azcopy list "<East-US-SAS-URL>"`
2. Check that all expected media files have been successfully transferred.
3. Reload the front end and backoffice of the **East US** project to confirm the images are displayed correctly.
When the media files have been migrated to the **East US** environment, the migration process is complete.


**Recommendation**\
It is highly recommended to thoroughly review the migrated site to ensure all media items are functioning as expected.
## Post-migration tasks

Following the steps above you have migrated your Umbraco project from one Cloud environment to another.
Expand Down
Loading