Skip to content

Files

Latest commit

AlexandraKemperMSAlexandraKemperMS
PR Feedback
Aug 25, 2021
1391e1b · Aug 25, 2021

History

History
128 lines (104 loc) · 8.22 KB

howto-move-resource-between-regions.md

File metadata and controls

128 lines (104 loc) · 8.22 KB
title description ms.service author ms.author ms.topic ms.date
Move an App Configuration store to another region
Learn how to move an App Configuration store to a different region.
azure-app-configuration
AlexandraKemperMS
alkemper
how-to
8/23/2021

Move an App Configuration store to another region

App Configuration stores are region-specific and can't be moved across regions automatically. You must create a new App Configuration store in the target region, then move your content from the source store to the new target store. You might move your configuration to another region for a number of reasons. For example, to take advantage of a new Azure region with Availability Zone support, to deploy features or services available in specific regions only, or to meet internal policy and governance requirements.

The following steps walk you through the process of creating a new target store and exporting your current store to the new region.

Design considerations

Before you begin, keep in mind the following concepts:

  • Configuration store names are globally unique.
  • You need to reconfigure your access policies and network configuration settings in the new configuration store.

Create the target configuration store

Portal

To create a new App Configuration store in the Portal, follow these steps:

  1. Sign in to the Azure portal. In the upper-left corner of the home page, select Create a resource. In the Search the Marketplace box, enter App Configuration and select Enter.

    Search for App Configuration

  2. Select App Configuration from the search results, and then select Create.

    Select Create

  3. On the Create App Configuration pane, enter the following settings:

    Setting Suggested value Description
    Subscription Your subscription Select the Azure subscription of your original store
    Resource group Your resource group Select the Azure resource group of your original store
    Resource name Globally unique name Enter a unique resource name to use for the target App Configuration store. This can not be the same name as the previous configuration store.
    Location Your target Location Select the target region you want to move your configuration store to.
    Pricing tier Standard Select the desired pricing tier. For more information, see the App Configuration pricing page.

  4. Select Review + create to validate your settings.

  5. Select Create. The deployment might take a few minutes.

  6. Once the resource has been deployed, recreate the access policies and network configuration settings of our source store. These will not be transferred with the configuration. This can include using manage identities, virtual networks, and public network access.

Azure CLI

To create a new App Configuration store in the CLI, follow these steps:

  1. Log in to the Azure CLI with your credentials.

    az login

  2. Create a new configuration store with the create command,

    az appconfig create -g MyResourceGroup -n MyResourceName -l targetlocation --sku Standard

    and enter the following settings:

    Setting Suggested value Description
    Resource group Your resource group Select the Azure resource group of your original store
    Resource name Globally unique name Enter a unique resource name to use for the target App Configuration store. This can not be the same name as the previous configuration store.
    Location Your target Location Select the target region you want to move your configuration store to.
    Sku Standard Select the desired pricing tier. For more information, see the App Configuration pricing page.

  3. The deployment might take a few minutes. Once it is complete, recreate the access policies and network configuration settings of our source store. These will not be transferred with the configuration values. This can include using manage identities, virtual networks, and public network access. For more information, reference the CLI documentation.

Transfer your configuration key-values

Portal

Follow these steps to export your configuration to the target store using the Portal:

  1. Navigate to your source configuration store in the Azure portal and select Import/Export under Operations .
  2. Select Export and choose App Configuration in the Target Service dropdown. Export to another configuration store
  3. Click on Select Resource and enter your Subscription and Resource group. The Resource is the name of the target configuration store you created previously.
  4. Select Apply to verify your target configuration store.
  5. Leave the from label, time, and Label fields as their default values and select Apply.
  6. To verify that your configurations have been successfully transferred from your source to your target store, navigate to your target configuration store in the portal. Select Configuration Explorer under Operations and verify that this contains the same key value pairs as those in your original store.

    [!NOTE] This process only allows for configuration key-values to be exported by one label at a time. To export multiple, repeat steps 2-5 for each label.

Azure CLI

Follow these steps to export your configuration to the target store using the Azure:

  1. In the Azure CLI, enter the following command that will export all of the values from your source configuration store to your target configuration store. 
    az appconfig kv export -n SourceConfigurationStore -d appconfig --dest-name TargetConfigurationStore --key * --label * --preserve-labels
  2. To verify that your configurations have been successfully transferred from your source to your target store, list all of the key values in your target store. 
    az appconfig kv list -n TargetAppConfiguration --all

Delete your source configuration store

If the configuration has been transferred to the target store, you can choose to delete your source configuration store.

Portal

Follow these steps to delete your source configuration store in the Portal:

  1. Sign in to the Azure portal, and select Resource groups.
  2. In the Filter by name box, enter the name of your resource group.
  3. In the result list, select the resource group name to see an overview.
  4. Select your source configuration store, and on the Overview blade, select Delete.
  5. You're asked to confirm the deletion of the configuration store, select Yes.

After a few moments, the source configuration store will have been deleted.

Azure CLI

Follow these steps to delete your source configuration store in the Azure CLI:

  1. In the Azure CLI, run the following command: 
    az appconfig delete -g ResourceGroupName -n SourceConfiguration
    Note that the Resource Group is the one associated with your source Configuration store.
  2. Deleting the source configuration store might take a few moments. You can verify that the operation was successful by listing all of the current configuration stores in your resource group. 
    az appconfig list -g MyResourceGroup
    After a few moments, the source configuration store will have been deleted.

Next steps

[!div class="nextstepaction"] Automatically back up key-values from Azure App Configuration stores Azure App Configuration resiliency and disaster recovery