Merge pull request #209626 from maud-lv/ml-aac-backup

Add note about geo-replication

Author: prmerger-automator[bot]

articles/azure-app-configuration/howto-backup-config-store.md

@@ -8,7 +8,7 @@ ms.service: azure-app-configuration
 ms.devlang: csharp
 ms.custom: devx-track-dotnet, devx-track-azurecli
 ms.topic: how-to
-ms.date: 04/27/2020
+ms.date: 08/24/2022
 ms.author: avgupta
 
 
@@ -17,13 +17,16 @@ ms.author: avgupta
 
 # Back up App Configuration stores automatically
 
-In this article, you'll learn how to set up an automatic backup of key-values from a primary Azure App Configuration store to a secondary store. The automatic backup uses the integration of Azure Event Grid with App Configuration. 
+In this article, you'll learn how to set up an automatic backup of key-values from a primary Azure App Configuration store to a secondary store. The automatic backup uses the integration of Azure Event Grid with App Configuration.
 
-After you set up the automatic backup, App Configuration will publish events to Azure Event Grid for any changes made to key-values in a configuration store. Event Grid supports a variety of Azure services from which users can subscribe to the events emitted whenever key-values are created, updated, or deleted.
+After you set up the automatic backup, App Configuration will publish events to Azure Event Grid for any changes made to key-values in a configuration store. Event Grid supports various Azure services from which users can subscribe to the events emitted whenever key-values are created, updated, or deleted.
+
+> [!IMPORTANT]
+> Azure App Configuration added [geo-replication](./concept-geo-replication.md) support recently. You can enable replicas of your data across multiple locations for enhanced resiliency to regional outages. You can also leverage App Configuration provider libraries in your applications for [automatic failover](./howto-geo-replication.md#use-replicas). The geo-replication feature is currently under preview. It will be the recommended solution for high availability when the feature is generally available.
 
 ## Overview
 
-In this article, you'll use Azure Queue storage to receive events from Event Grid and use a timer-trigger of Azure Functions to process events in the queue in batches. 
+In this article, you'll use Azure Queue storage to receive events from Event Grid and use a timer-trigger of Azure Functions to process events in the queue in batches.
 
 When a function is triggered, based on the events, it will fetch the latest values of the keys that have changed from the primary App Configuration store and update the secondary store accordingly. This setup helps combine multiple changes that occur in a short period in one backup operation, which avoids excessive requests made to your App Configuration stores.
 
@@ -37,7 +40,7 @@ In this tutorial, you'll create a secondary store in the `centralus` region and
 
 [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)].
 
-## Prerequisites 
+## Prerequisites
 
 - [Visual Studio 2019](https://visualstudio.microsoft.com/vs) with the Azure development workload.
 
@@ -121,6 +124,7 @@ az eventgrid event-subscription create \
 ### Set up with ready-to-use functions
 
 In this article, you'll work with C# functions that have the following properties:
+
 - Runtime stack .NET Core 3.1
 - Azure Functions runtime version 3.x
 - Function triggered by timer every 10 minutes
@@ -134,6 +138,7 @@ To make it easier for you to start backing up your data, we've [tested and publi
 ### Build your own function
 
 If the sample code provided earlier doesn't meet your requirements, you can also create your own function. Your function must be able to perform the following tasks in order to complete the backup:
+
 - Periodically read contents of your queue to see if it contains any notifications from Event Grid. Refer to the [Storage Queue SDK](../storage/queues/storage-quickstart-queues-dotnet.md) for implementation details.
 - If your queue contains [event notifications from Event Grid](./concept-app-configuration-event.md#event-schema), extract all the unique `<key, label>` information from event messages. The combination of key and label is the unique identifier for key-value changes in the primary store.
 - Read all settings from the primary store. Update only those settings in the secondary store that have a corresponding event in the queue. Delete all settings from the secondary store that were present in the queue but not in the primary store. You can use the [App Configuration SDK](https://github.com/Azure/AppConfiguration#sdks) to access your configuration stores programmatically.
@@ -142,15 +147,14 @@ If the sample code provided earlier doesn't meet your requirements, you can also
 
 To learn more about creating a function, see: [Create a function in Azure that is triggered by a timer](../azure-functions/functions-create-scheduled-function.md) and [Develop Azure Functions using Visual Studio](../azure-functions/functions-develop-vs.md).
 
-
 > [!IMPORTANT]
 > Use your best judgement to choose the timer schedule based on how often you make changes to your primary configuration store. Running the function too often might end up throttling requests for your store.
 >
 
-
 ## Create function app settings
 
 If you're using a function that we've provided, you need the following app settings in your function app:
+
 - `PrimaryStoreEndpoint`: Endpoint for the primary App Configuration store. An example is `https://{primary_appconfig_name}.azconfig.io`.
 - `SecondaryStoreEndpoint`: Endpoint for the secondary App Configuration store. An example is `https://{secondary_appconfig_name}.azconfig.io`.
 - `StorageQueueUri`: Queue URI. An example is `https://{unique_storage_name}.queue.core.windows.net/{queue_name}`.
@@ -165,7 +169,6 @@ storageQueueUri="https://$storageName.queue.core.windows.net/$queueName"
 az functionapp config appsettings set --name $functionAppName --resource-group $resourceGroupName --settings StorageQueueUri=$storageQueueUri PrimaryStoreEndpoint=$primaryStoreEndpoint SecondaryStoreEndpoint=$secondaryStoreEndpoint
 ```
 
-
 ## Grant access to the managed identity of the function app
 
 Use the following command or the [Azure portal](../app-service/overview-managed-identity.md#add-a-system-assigned-identity) to add a system-assigned managed identity for your function app.
@@ -178,6 +181,7 @@ az functionapp identity assign --name $functionAppName --resource-group $resourc
 > To perform the required resource creation and role management, your account needs `Owner` permissions at the appropriate scope (your subscription or resource group). If you need assistance with role assignment, learn [how to assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
 
 Use the following commands or the [Azure portal](./howto-integrate-azure-managed-service-identity.md#grant-access-to-app-configuration) to grant the managed identity of your function app access to your App Configuration stores. Use these roles:
+
 - Assign the `App Configuration Data Reader` role in the primary App Configuration store.
 - Assign the `App Configuration Data Owner` role in the secondary App Configuration store.
 
@@ -246,11 +250,11 @@ If you don't see the new setting in your secondary store:
 - It's possible that Event Grid couldn't send the event notification to the queue in time. Check if your queue still contains the event notification from your primary store. If it does, trigger the backup function again.
 - Check [Azure Functions logs](../azure-functions/functions-create-scheduled-function.md#test-the-function) for any errors or warnings.
 - Use the [Azure portal](../azure-functions/functions-how-to-use-azure-function-app-settings.md#get-started-in-the-azure-portal) to ensure that the Azure function app contains correct values for the application settings that Azure Functions is trying to read.
-- You can also set up monitoring and alerting for Azure Functions by using [Azure Application Insights](../azure-functions/functions-monitoring.md?tabs=cmd). 
-
+- You can also set up monitoring and alerting for Azure Functions by using [Azure Application Insights](../azure-functions/functions-monitoring.md?tabs=cmd).
 
 ## Clean up resources
-If you plan to continue working with this App Configuration and event subscription, don't clean up the resources created in this article. If you don't plan to continue, use the following command to delete the resources created in this article.
+
+If you plan to continue working with this App Configuration and event subscription, you might want to leave these resources in place. If you don't plan to continue, use the [az group delete](/cli/azure/group#az-group-delete) command, which deletes the resource group and the resources in it.
 
 ```azurecli-interactive
 az group delete --name $resourceGroupName
@@ -260,4 +264,5 @@ az group delete --name $resourceGroupName
 
 Now that you know how to set up automatic backup of your key-values, learn more about how you can increase the geo-resiliency of your application:
 
-- [Resiliency and disaster recovery](concept-disaster-recovery.md)
+> [!div class="nextstepaction"]
+> [Resiliency and disaster recovery](concept-disaster-recovery.md)