Migrate web resources to global Azure

  • Article

Important

Since August 2018, we have not been accepting new customers or deploying any new features and services into the original Microsoft Cloud Germany locations.

Based on the evolution in customers’ needs, we recently launched two new datacenter regions in Germany, offering customer data residency, full connectivity to Microsoft’s global cloud network, as well as market competitive pricing.

Additionally, on Sept 30th, 2020, we announced that the Microsoft Cloud Germany would be closing on October 29th, 2021. More details are available here: https://www.microsoft.com/cloud-platform/germany-cloud-regions.

Take advantage of the breadth of functionality, enterprise-grade security, and comprehensive features available in our new German datacenter regions by migrating today.

This article has information that can help you migrate Azure web resources from Azure Germany to global Azure.

Web Apps

Migrating apps that you created by using the Web Apps feature of Azure App Service from Azure Germany to global Azure isn't supported at this time. We recommend that you export a web app as an Azure Resource Manager template. Then, redeploy after you change the location property to the new destination region.

Important

Change location, Azure Key Vault secrets, certificates, and other GUIDs to be consistent with the new region.

Migrate Web App resource

  1. Export Web App and App Service plan as a template from your Azure Germany subscription. Select the resources you want to migrate in your web app resource group and export as a template.

  2. Download the template as a zip file.

  3. Edit the location property in the template.json file to the target Azure global region. For example, the following JSON file has a target location of West US.

        "resources": [
    {
        "type": "Microsoft.Web/serverfarms",
        "apiVersion": "2018-02-01",
        "name": "[parameters('serverfarms_myappservice_name')]",
        "location": "West US",

  4. Deploy the modified template to Azure global. For example, you can use PowerShell to deploy.

    az deployment group create --name "<web app name>" \
    --resource-group "<resource group name>" \
    --template-file "<path of your template.json file>"

Migrate Web App content

  1. In the Azure Germany portal, select your Web App.

  2. Select Development Tools > Advanced Tools.

  3. From the top menu, select Debug console then choose PowerShell.

  4. Select site.

  5. Select the download icon beside the wwwroot folder. The downloaded zip file contains source code of your web app.

  6. Deploy the web root to the migrated Azure global web app. For example, you can use the following PowerShell script.

    az webapp deployment source config-zip \
    --resource-group "<resource group name>" \
    --name "<web App name>" \
    --src "path to webroot folder zip file"

For more information:

Notification Hubs

To migrate settings from one Azure Notification Hubs instance to another instance, export and import all registration tokens with their tags:

  1. Export the existing notification hub registrations to an Azure Blob storage container.
  2. Create a new notification hub in the target environment.
  3. Import your registration tokens from Blob storage to your new notification hub.

For more information:

Event Hubs

To migrate an Azure Event Hub, you export the Event Hub resource template from Azure Germany then deploy the template to global Azure.

  1. Export Event Hub as a template from your Azure Germany subscription.
  2. Deploy Event Hub template as a custom template to your global Azure subscription. Load and deploy the template you exported from your Azure Germany subscription.

For more information:

Next steps

Learn about tools, techniques, and recommendations for migrating resources in the following service categories: