From bef6060836e41438cb89fc3cd67cd343ed111079 Mon Sep 17 00:00:00 2001 From: Jacob Welander Jensen <64834767+Welander1994@users.noreply.github.com> Date: Wed, 8 Jan 2025 10:13:06 +0100 Subject: [PATCH 1/6] Update migrate-between-regions.md Updated step 4 to use Azcopy instead of downloading blob --- .../migrate-between-regions.md | 37 ++++++++++++++----- 1 file changed, 28 insertions(+), 9 deletions(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index 993d188fddf..b52e17564d8 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -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 "" "" --recursive` + + - Replace `` with the SAS URL of the **West EU** blob storage container. + - Replace `` 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 ""` + + 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. + +**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. From 39437a60141b1c33c852a1cfa5a10d3b272f309a Mon Sep 17 00:00:00 2001 From: Jacob Welander Jensen <64834767+Welander1994@users.noreply.github.com> Date: Wed, 8 Jan 2025 14:41:49 +0100 Subject: [PATCH 2/6] Update umbraco-cloud/getting-started/migrate-between-regions.md Co-authored-by: sofietoft --- umbraco-cloud/getting-started/migrate-between-regions.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index b52e17564d8..a1cb31066e4 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -88,9 +88,10 @@ Verify that all schemas, files, and content have been successfully deployed to y 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. **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. +#### Download AzCopy Portable Binary + +1. Download AzCopy Portable Binary from the [official Microsoft AzCopy page](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10#download-azcopy). +2. Extract the binary to a directory on your local machine and ensure you can run it from the command line. 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.\ From 5f2fe7296e470d36ad873b68dd5c5ccfd778d09e Mon Sep 17 00:00:00 2001 From: Jacob Welander Jensen <64834767+Welander1994@users.noreply.github.com> Date: Wed, 8 Jan 2025 14:41:59 +0100 Subject: [PATCH 3/6] Update umbraco-cloud/getting-started/migrate-between-regions.md Co-authored-by: sofietoft --- .../getting-started/migrate-between-regions.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index a1cb31066e4..7bdc52f59d0 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -93,9 +93,15 @@ In the following steps, we will migrate media items from the **West EU** blob st 1. Download AzCopy Portable Binary from the [official Microsoft AzCopy page](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10#download-azcopy). 2. Extract the binary to a directory on your local machine and ensure you can run it from the command line. -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. +#### Locate the SAS URLs + +1. Access the Umbraco Cloud Portal for the West EU project. +2. Open the **Connections** page found under **Configuration**. +3. Locate the **Shared Access Signature (SAS)**. +4. Ensure the SAS tokens can read from the **West EU** container. +5. Access the Umbraco Cloud Portal for the East US project. +6. Open the **Connections** page. +7. Locate the **Shared Access Signature (SAS)** and ensure the tokens can write to the **East US** container. 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: From 72cd502e06711f42e8e6c86b13afbf830183721c Mon Sep 17 00:00:00 2001 From: sofietoft Date: Fri, 10 Jan 2025 09:26:10 +0100 Subject: [PATCH 4/6] Apply suggestions from code review --- .../migrate-between-regions.md | 31 ++++++++++--------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index 7bdc52f59d0..a5096c89aea 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -103,28 +103,29 @@ In the following steps, we will migrate media items from the **West EU** blob st 6. Open the **Connections** page. 7. Locate the **Shared Access Signature (SAS)** and ensure the tokens can write to the **East US** container. -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: +#### Copy the Media Files - `azcopy copy "" "" --recursive` +Use the following AzCopy command to transfer the media files from the **West EU** container to the **East US** container: - - Replace `` with the SAS URL of the **West EU** blob storage container. - - Replace `` 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 copy "" "" --recursive` - `azcopy list ""` +- Replace `` with the SAS URL of the **West EU** blob storage container. +- Replace `` with the SAS URL of the **East US** blob storage container. +- The `--recursive` flag ensures that all files and subfolders are copied. - Check that all expected media files have been successfully transferred. +#### Verify the File Transfer -5. **Reload the Project**\ - Reload the front end and backoffice of the **East US** project to confirm that the images are displayed correctly. +1. verify the files in the **East US** container using AzCopy: +`azcopy list ""` +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. +The migration process is complete when the media files have been migrated to the **East US** environment. -**Recommendation**\ -It is highly recommended to thoroughly review the migrated site to ensure all media items are functioning as expected. +{% hint style="info" %} +**Recommendation** +It is highly recommended that the migrated site be thoroughly reviewed to ensure all media items function as expected. +{% endhint %} ## Post-migration tasks Following the steps above you have migrated your Umbraco project from one Cloud environment to another. From ebf8c838baebd6dc3fcbd83cceba9c41c95e68f8 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Fri, 10 Jan 2025 09:29:06 +0100 Subject: [PATCH 5/6] Update migrate-between-regions.md --- umbraco-cloud/getting-started/migrate-between-regions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index a5096c89aea..3fb8c585852 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -93,15 +93,15 @@ In the following steps, we will migrate media items from the **West EU** blob st 1. Download AzCopy Portable Binary from the [official Microsoft AzCopy page](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10#download-azcopy). 2. Extract the binary to a directory on your local machine and ensure you can run it from the command line. -#### Locate the SAS URLs +#### Locate the Shared Access Signature (SAS) URLs 1. Access the Umbraco Cloud Portal for the West EU project. 2. Open the **Connections** page found under **Configuration**. -3. Locate the **Shared Access Signature (SAS)**. +3. Locate the SAS URLs. 4. Ensure the SAS tokens can read from the **West EU** container. 5. Access the Umbraco Cloud Portal for the East US project. 6. Open the **Connections** page. -7. Locate the **Shared Access Signature (SAS)** and ensure the tokens can write to the **East US** container. +7. Locate the SAS URLs and ensure the tokens can write to the **East US** container. #### Copy the Media Files From 7315b78dadc73b85b8a715bfea71860466eaeb77 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Fri, 10 Jan 2025 09:56:12 +0100 Subject: [PATCH 6/6] Update migrate-between-regions.md --- umbraco-cloud/getting-started/migrate-between-regions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/getting-started/migrate-between-regions.md b/umbraco-cloud/getting-started/migrate-between-regions.md index 3fb8c585852..9bde14ab67a 100644 --- a/umbraco-cloud/getting-started/migrate-between-regions.md +++ b/umbraco-cloud/getting-started/migrate-between-regions.md @@ -115,7 +115,7 @@ Use the following AzCopy command to transfer the media files from the **West EU* #### Verify the File Transfer -1. verify the files in the **East US** container using AzCopy: +1. Verify the files in the **East US** container using AzCopy: `azcopy list ""` 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.