|
| 1 | +--- |
| 2 | +title: Move a Service Fabric Mesh application to another region |
| 3 | +description: You can move Service Fabric Mesh resources by deploying a copy of your current template to a new Azure region. |
| 4 | +author: erikadoyle |
| 5 | +ms.author: edoyle |
| 6 | +ms.topic: how-to |
| 7 | +ms.date: 01/14/2020 |
| 8 | +ms.custom: subject-moving-resources |
| 9 | +#Customer intent: As an Azure service administrator, I want to move my Service Fabric Mesh resources to another Azure region. |
| 10 | +--- |
| 11 | +# Move a Service Fabric Mesh application to another Azure region |
| 12 | + |
| 13 | +This article describes how to move your Service Fabric Mesh application and its resources to a different Azure region. You might move your resources to another region for a number of reasons. For example, in response to outages, to gain features or services available in specific regions only, to meet internal policy and governance requirements, or in response to capacity planning requirements. |
| 14 | + |
| 15 | + [Service Fabric Mesh does not support](../azure-resource-manager/management/region-move-support.md#microsoftservicefabricmesh) the ability to directly move resources across Azure regions. However, you can move resources indirectly by deploying a copy of your current Azure Resource Manager template to the new target region and then redirecting ingress traffic and dependencies to the newly created Service Fabric Mesh application. |
| 16 | + |
| 17 | +## Prerequisites |
| 18 | + |
| 19 | +* Ingress controller (such as [Application Gateway](https://docs.microsoft.com/azure/application-gateway/)) to serve as an intermediary for routing traffic between clients and your Service Fabric Mesh application |
| 20 | +* Service Fabric Mesh (Preview) availability in the target Azure region (`westus`, `eastus`, or `westeurope`) |
| 21 | + |
| 22 | +## Prepare |
| 23 | + |
| 24 | +1. Take a "snapshot" of the current state of your Service Fabric Mesh application by exporting the Azure Resource Manager template and parameters from the most recent deployment. To do this, follow the steps in [Export template after deployment](../azure-resource-manager/templates/export-template-portal.md#export-template-after-deployment) using the Azure portal. You can also use [Azure CLI](../azure-resource-manager/management/manage-resource-groups-cli.md#export-resource-groups-to-templates), [Azure PowerShell](../azure-resource-manager/management/manage-resource-groups-powershell.md#export-resource-groups-to-templates), or [REST API](https://docs.microsoft.com/rest/api/resources/resourcegroups/exporttemplate). |
| 25 | + |
| 26 | +2. If applicable, [export other resources in the same resource group](https://docs.microsoft.com/azure/azure-resource-manager/templates/export-template-portal#export-template-from-a-resource-group) for redeployment in the target region. |
| 27 | + |
| 28 | +3. Review (and edit, if needed) the exported template to ensure the existing property values are the ones you want to use in the target region. The new `location` (Azure region) is a parameter that you will supply during redeployment. |
| 29 | + |
| 30 | +## Move |
| 31 | + |
| 32 | +1. Create a new resource group (or use an existing one) in the target region. |
| 33 | + |
| 34 | +2. With your exported template, follow the steps in [Deploy resources from custom template](https://docs.microsoft.com/azure/azure-resource-manager/templates/deploy-portal#deploy-resources-from-custom-template) using the Azure portal. You can also use [Azure CLI](https://docs.microsoft.com/azure/azure-resource-manager/templates/deploy-cli), [Azure PowerShell](https://docs.microsoft.com/azure/azure-resource-manager/templates/deploy-powershell), or [REST API](https://docs.microsoft.com/azure/azure-resource-manager/templates/deploy-rest). |
| 35 | + |
| 36 | +3. For guidance on moving related resources such as [Azure Storage accounts](../storage/common/storage-account-move.md), refer to guidance for individual services listed under the topic [Moving Azure resources across regions](../azure-resource-manager/management/move-region.md). |
| 37 | + |
| 38 | +## Verify |
| 39 | + |
| 40 | +1. When the deployment is complete, test the application endpoint(s) to verify the functionality of your application. |
| 41 | + |
| 42 | +2. You can also verify the status of your application by checking the application status ([az mesh app show](https://docs.microsoft.com/cli/azure/ext/mesh/mesh/app?view=azure-cli-latest#ext-mesh-az-mesh-app-show)) and reviewing the application logs and ([az mesh code-package-log](https://docs.microsoft.com/cli/azure/ext/mesh/mesh/code-package-log?view=azure-cli-latest)) commands using the [Azure Service Fabric Mesh CLI](https://docs.microsoft.com/azure/service-fabric-mesh/service-fabric-mesh-quickstart-deploy-container#set-up-service-fabric-mesh-cli). |
| 43 | + |
| 44 | +## Commit |
| 45 | + |
| 46 | +Once you've confirmed equivalent functionality of your Service Fabric Mesh application in the target region, configure your ingress controller (for example, [Application Gateway](../application-gateway/redirect-overview.md)) to redirect traffic to the new application. |
| 47 | + |
| 48 | +## Clean up source resources |
| 49 | + |
| 50 | +To complete the move of the Service Fabric Mesh application, [delete the source application and/or parent resource group](../azure-resource-manager/management/delete-resource-group.md). |
| 51 | + |
| 52 | +## Next steps |
| 53 | + |
| 54 | +* [Move Azure resources across regions](../azure-resource-manager/management/move-region.md) |
| 55 | +* [Support for moving Azure resources across regions](../azure-resource-manager/management/region-move-support.md) |
| 56 | +* [Move resources to a new resource group or subscription](../azure-resource-manager/management/move-resource-group-and-subscription.md) |
| 57 | +* [Move operation support for resources](../azure-resource-manager/management/move-support-resources.md |
| 58 | +) |
0 commit comments