Skip to content

Commit 3f92adb

Browse files
resolve comments
1 parent 76d50aa commit 3f92adb

13 files changed

+28
-26
lines changed

articles/azure-app-configuration/cli-samples.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ The following table includes links to Azure CLI scripts for Azure App Configurat
1818
|**Create**||
1919
| [Create an App Configuration store](./scripts/cli-create-service.md) | Creates a resource group and an App Configuration store instance. |
2020
|**Use**||
21-
| [Work with key values](./scripts/cli-work-with-keys.md) | Creates, views, updates, and deletes key values. |
22-
| [Import key values](./scripts/cli-import.md) | Imports key values from other sources. |
23-
| [Export key values](./scripts/cli-export.md) | Exports key values to other targets. |
21+
| [Work with key-values](./scripts/cli-work-with-keys.md) | Creates, views, updates, and deletes key-values. |
22+
| [Import key-values](./scripts/cli-import.md) | Imports key-values from other sources. |
23+
| [Export key-values](./scripts/cli-export.md) | Exports key-values to other targets. |
2424
|**Delete**||
2525
| [Delete an App Configuration store](./scripts/cli-delete-service.md) | Deletes an App Configuration store instance. |
2626
| | |

articles/azure-app-configuration/concept-customer-managed-keys.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -38,16 +38,11 @@ After these resources are configured, use the following steps so that the Azure
3838
1. Assign a managed identity to the Azure App Configuration instance.
3939
1. Grant the identity `GET`, `WRAP`, and `UNWRAP` permissions in the target Key Vault's access policy.
4040

41-
## Enable customer-managed key encryption for your Azure App Configuration instance
41+
## Enable customer-managed key encryption for your App Configuration store
4242

43-
To begin, you'll need a properly configured Azure App Configuration instance. If you don't yet have an App Configuration instance available, follow one of these quickstarts to set one up:
43+
1. [Create an App Configuration store](quickstart-azure-app-configuration-create) if you don't have one.
44+
1. Create an Azure Key Vault by using the Azure CLI.
4445

45-
- [Create an ASP.NET Core app with Azure App Configuration](quickstart-aspnet-core-app.md)
46-
- [Create a .NET app with Azure App Configuration](quickstart-dotnet-core-app.md)
47-
- [Create a .NET Framework app with Azure App Configuration](quickstart-dotnet-app.md)
48-
- [Create a Java Spring app with Azure App Configuration](quickstart-java-spring-app.md)
49-
- [Create a JavaScript app with Azure App Configuration](quickstart-javascript.md)
50-
- [Create a Python app with Azure App Configuration](quickstart-python.md)
5146

5247
> [!TIP]
5348
> The Azure Cloud Shell is a free interactive shell that you can use to run the command line instructions in this article. It has common Azure tools preinstalled, including the .NET Core SDK. If you are logged in to your Azure subscription, launch your [Azure Cloud Shell](https://shell.azure.com) from shell.azure.com. You can learn more about Azure Cloud Shell by [reading our documentation](../cloud-shell/overview.md).

articles/azure-app-configuration/concept-feature-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ To use feature flags effectively, you need to externalize all the feature flags
7474

7575
Azure App Configuration provides a centralized repository for feature flags. You can use it to define different kinds of feature flags and manipulate their states quickly and confidently. You can then use the App Configuration libraries for various programming language frameworks to easily access these feature flags from your application.
7676

77-
[The feature flags in an ASP.NET Core app](./use-feature-flags-dotnet-core.md) shows how the .NET App Configuration provider and Feature Management libraries are used together to implement feature flags for your ASP.NET web application. For more information on feature flags in Azure App Configuration, see the following articles:
77+
[The feature flags in an ASP.NET Core app](./use-feature-flags-dotnet-core.md) shows how the App Configuration .NET provider and Feature Management libraries are used together to implement feature flags for your ASP.NET web application. For more information on feature flags in Azure App Configuration, see the following articles:
7878

7979
* [Manage feature flags](./manage-feature-flags.md)
8080
* [Use conditional feature flags](./howto-feature-filters-aspnet-core.md)

articles/azure-app-configuration/concept-point-time-snapshot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ You can use the Azure portal or the Azure CLI to retrieve past key-values.
2828
:::image type="content" source="media/restore-key-value-portal.png" alt-text="Screenshot of the Azure portal, selecting restore":::
2929

3030
3. Select **Date: Select date** to select a date and time you want to revert to.
31-
4. Click outside of the date and time fields or press **Tab** to validate your choice. You can now see which key values have changed between your selected date and time and the current time. This step helps you understand what keys and values you're preparing to revert to.
31+
4. Click outside of the date and time fields or press **Tab** to validate your choice. You can now see which key-values have changed between your selected date and time and the current time. This step helps you understand what keys and values you're preparing to revert to.
3232

3333
:::image type="content" source="media/restore-key-value-past-values.png" alt-text="Screenshot of the Azure portal with saved key-values":::
3434

articles/azure-app-configuration/enable-dynamic-configuration-dotnet-core.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Finish the quickstart [Create a .NET app with App Configuration](./quickstart-do
3333

3434
## Activity-driven configuration refresh
3535

36-
Open the `Program.cs` file and update the code configurations to match the following:
36+
Open *Program.cs* and update the file with the following code.
3737

3838
```csharp
3939
using Microsoft.Extensions.Configuration;

articles/azure-app-configuration/howto-best-practices.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,15 +27,15 @@ You can use either one or both options to group your keys.
2727

2828
An important thing to keep in mind is that keys are what your application code references to retrieve the values of the corresponding settings. Keys shouldn't change, or else you'll have to modify your code each time that happens.
2929

30-
*Labels* are an attribute on keys. They're used to create variants of a key. For example, you can assign labels to multiple versions of a key. A version might be an iteration, an environment, or some other contextual information. Your application can request an entirely different set of key values by specifying another label. As a result, all key references remain unchanged in your code.
30+
*Labels* are an attribute on keys. They're used to create variants of a key. For example, you can assign labels to multiple versions of a key. A version might be an iteration, an environment, or some other contextual information. Your application can request an entirely different set of key-values by specifying another label. As a result, all key references remain unchanged in your code.
3131

3232
## Key-value compositions
3333

34-
App Configuration treats all keys stored with it as independent entities. App Configuration doesn't attempt to infer any relationship between keys or to inherit key values based on their hierarchy. You can aggregate multiple sets of keys, however, by using labels coupled with proper configuration stacking in your application code.
34+
App Configuration treats all keys stored with it as independent entities. App Configuration doesn't attempt to infer any relationship between keys or to inherit key-values based on their hierarchy. You can aggregate multiple sets of keys, however, by using labels coupled with proper configuration stacking in your application code.
3535

3636
Let's look at an example. Suppose you have a setting named **Asset1**, whose value might vary based on the development environment. You create a key named "Asset1" with an empty label and a label named "Development". In the first label, you put the default value for **Asset1**, and you put a specific value for "Development" in the latter.
3737

38-
In your code, you first retrieve the key values without any labels, and then you retrieve the same set of key values a second time with the "Development" label. When you retrieve the values the second time, the previous values of the keys are overwritten. The .NET configuration system allows you to "stack" multiple sets of configuration data on top of each other. If a key exists in more than one set, the last set that contains it is used. With a modern programming framework, such as .NET, you get this stacking capability for free if you use a native configuration provider to access App Configuration. The following code snippet shows how you can implement stacking in a .NET application:
38+
In your code, you first retrieve the key-values without any labels, and then you retrieve the same set of key-values a second time with the "Development" label. When you retrieve the values the second time, the previous values of the keys are overwritten. The .NET configuration system allows you to "stack" multiple sets of configuration data on top of each other. If a key exists in more than one set, the last set that contains it is used. With a modern programming framework, such as .NET, you get this stacking capability for free if you use a native configuration provider to access App Configuration. The following code snippet shows how you can implement stacking in a .NET application:
3939

4040
```csharp
4141
// Augment the ConfigurationBuilder with Azure App Configuration

articles/azure-app-configuration/howto-integrate-azure-managed-service-identity.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,14 +45,16 @@ To complete this tutorial, you must have:
4545

4646
:::zone target="docs" pivot="framework-dotnet"
4747

48+
* An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/en-us/free/).
49+
* An Azure App Configuration store. [Create a store](./quickstart-azure-app-configuration-create.md).
4850
* [.NET SDK 6.0 or later](https://dotnet.microsoft.com/download).
49-
* [Azure Cloud Shell configured](../cloud-shell/quickstart.md).
5051

5152
:::zone-end
5253

5354
:::zone target="docs" pivot="framework-spring"
5455

55-
* Azure subscription - [create one for free](https://azure.microsoft.com/free/)
56+
* An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/en-us/free/).
57+
* An Azure App Configuration store. [Create a store](./quickstart-azure-app-configuration-create.md).
5658
* A supported [Java Development Kit (JDK)](/java/azure/jdk) with version 11.
5759
* [Apache Maven](https://maven.apache.org/download.cgi) version 3.0 or above.
5860

@@ -78,7 +80,7 @@ To set up a managed identity in the portal, you first create an application and
7880

7981
The following steps describe how to assign the App Configuration Data Reader role to App Service. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
8082

81-
1. In the [Azure portal](https://portal.azure.com), select the App Configuration store that you created in the [quickstart](../azure-app-configuration/quickstart-azure-functions-csharp.md).
83+
1. In the [Azure portal](https://portal.azure.com), select your App Configuration store.
8284

8385
1. Select **Access control (IAM)**.
8486

articles/azure-app-configuration/howto-move-resource-between-regions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Follow these steps to export your configuration to the target store using the Az
5454
az appconfig kv export -n SourceConfigurationStore -d appconfig --dest-name TargetConfigurationStore --key * --label * --preserve-labels
5555
```
5656
57-
1. 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.
57+
1. 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.
5858
5959
```azurecli
6060
az appconfig kv list -n TargetAppConfiguration --all

articles/azure-app-configuration/integrate-kubernetes-deployment-helm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ Use helm upgrade's **-f** argument to pass in the two configuration files you've
208208
helm upgrade --install -f myConfig.yaml -f mySecrets.yaml "example" ./mychart
209209
```
210210

211-
You can also use the **--set** argument for helm upgrade to pass literal key values. Using the **--set** argument is a good way to avoid persisting sensitive data to disk.
211+
You can also use the **--set** argument for helm upgrade to pass literal key-values. Using the **--set** argument is a good way to avoid persisting sensitive data to disk.
212212

213213
```powershell
214214
$secrets = az appconfig kv list -n myAppConfiguration --key "secrets.*" --resolve-keyvault --query "[*].{name:key, value:value}" | ConvertFrom-Json

articles/azure-app-configuration/manage-feature-flags.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,12 @@ ms.custom: "devx-track-csharp, mvc"
1515

1616
# Tutorial: Manage feature flags in Azure App Configuration
1717

18-
You can store all feature flags in Azure App Configuration and administer them from a single place. App Configuration has a portal UI named **Feature Manager** that's designed specifically for feature flags. App Configuration also natively supports the .NET feature-flag data schema.
18+
You can create feature flags in Azure App Configuration and manage them from the **Feature Manager** in the Azure portal.
1919

2020
In this tutorial, you learn how to:
2121

2222
> [!div class="checklist"]
2323
> * Define and manage feature flags in App Configuration.
24-
> * Access feature flags from your application.
2524
2625
## Create feature flags
2726

0 commit comments

Comments
 (0)