Azure App Configuration client integration #8945
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -23,6 +23,7 @@ | |
| <PackageVersion Include="Azure.Security.KeyVault.Secrets" Version="4.7.0" /> | ||
| <PackageVersion Include="Azure.Storage.Blobs" Version="12.24.0" /> | ||
| <PackageVersion Include="Azure.Storage.Queues" Version="12.22.0" /> | ||
| <PackageVersion Include="Microsoft.Extensions.Configuration.AzureAppConfiguration" Version="8.1.1" /> | ||
|
There was a problem hiding this comment. Waiting for 8.2.0 to have tracing support. (Hopefully, it will be released next week) There was a problem hiding this comment. Would the current preview version have the tracing feature? If so then you could complete the PR and just switch the version when it's no more preview. There was a problem hiding this comment. No, the current preview version doesn't support tracing. |
||
| <PackageVersion Include="Microsoft.Azure.AppConfiguration.AspNetCore" Version="8.1.1" /> | ||
| <PackageVersion Include="Microsoft.Azure.Cosmos" Version="3.47.2" /> | ||
| <PackageVersion Include="Microsoft.Azure.SignalR" Version="1.30.2" /> | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
|
|
||
| <PropertyGroup> | ||
| <TargetFramework>$(DefaultTargetFramework)</TargetFramework> | ||
| <IsPackable>true</IsPackable> | ||
| <PackageTags>$(ComponentAzurePackageTags) configuration appconfiguration</PackageTags> | ||
| <Description>A client for Azure App Configuration that integrates with Aspire.</Description> | ||
| <PackageIconFullPath>$(SharedDir)AzureAppConfig_256x.png</PackageIconFullPath> | ||
| <NoWarn>$(NoWarn);SYSLIB1100;SYSLIB1101</NoWarn> | ||
| <!-- Disable package validation as this package hasn't shipped stable yet. --> | ||
| <EnablePackageValidation>false</EnablePackageValidation> | ||
| </PropertyGroup> | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| <ItemGroup> | ||
| <Compile Include="..\Common\AzureComponent.cs" Link="AzureComponent.cs" /> | ||
| <Compile Include="..\Common\ConfigurationSchemaAttributes.cs" Link="ConfigurationSchemaAttributes.cs" /> | ||
| <Compile Include="..\Common\HealthChecksExtensions.cs" Link="HealthChecksExtensions.cs" /> | ||
| </ItemGroup> | ||
|
|
||
| <ItemGroup> | ||
| <PackageReference Include="Microsoft.Extensions.Azure" /> | ||
| <PackageReference Include="Microsoft.Extensions.Configuration.Binder" /> | ||
| <PackageReference Include="Microsoft.Extensions.Diagnostics.HealthChecks" /> | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" /> | ||
| <PackageReference Include="OpenTelemetry.Extensions.Hosting" /> | ||
| <PackageReference Include="Microsoft.Extensions.Configuration.AzureAppConfiguration" /> | ||
sebastienros marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| </ItemGroup> | ||
|
|
||
| </Project> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| // Licensed to the .NET Foundation under one or more agreements. | ||
| // The .NET Foundation licenses this file to you under the MIT license. | ||
|
|
||
| using Aspire.Azure.AppConfiguration; | ||
| using Azure.Identity; | ||
| using Microsoft.Extensions.Configuration.AzureAppConfiguration; | ||
| using Microsoft.Extensions.Configuration; | ||
| using Microsoft.Extensions.DependencyInjection; | ||
| using Aspire.Azure.Common; | ||
|
|
||
| namespace Microsoft.Extensions.Hosting; | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| /// <summary> | ||
| /// Provides extension methods for registering and configuring Azure App Configuration in a .NET Aspire application. | ||
| /// </summary> | ||
| public static class AspireAppConfigurationExtensions | ||
| { | ||
| internal const string DefaultConfigSectionName = "Aspire:Azure:AppConfiguration"; | ||
|
|
||
| /// <summary> | ||
| /// Adds the Azure App Configuration to be configuration in the <paramref name="builder"/>. | ||
| /// </summary> | ||
| /// <param name="builder">The <see cref="IHostApplicationBuilder" /> to read config from and add services to.</param> | ||
| /// <param name="connectionName">A name used to retrieve the connection string from the ConnectionStrings configuration section.</param> | ||
| /// <param name="configureSettings">An optional method that can be used for customizing the <see cref="AzureAppConfigurationSettings"/>. It's invoked after the settings are read from the configuration.</param> | ||
| /// <param name="configureOptions">An optional method that can be used for customizing the <see cref="AzureAppConfigurationOptions"/>.</param> | ||
| /// <param name="optional">Determines the behavior of the App Configuration provider when an exception occurs while loading data from server. If false, the exception is thrown. If true, the exception is suppressed and no settings are populated from Azure App Configuration.</param> | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| /// <remarks>Reads the configuration from "Aspire:Azure:AppConfiguration" section.</remarks> | ||
| /// <exception cref="InvalidOperationException">Thrown when mandatory <see cref="AzureAppConfigurationSettings.Endpoint"/> is not provided.</exception> | ||
| public static void AddAzureAppConfiguration( | ||
| this IHostApplicationBuilder builder, | ||
| string connectionName, | ||
| Action<AzureAppConfigurationSettings>? configureSettings = null, | ||
| Action<AzureAppConfigurationOptions>? configureOptions = null, | ||
| bool optional = false) | ||
| { | ||
| ArgumentNullException.ThrowIfNull(builder); | ||
| ArgumentException.ThrowIfNullOrEmpty(connectionName); | ||
|
|
||
| IConfigurationSection configSection = builder.Configuration.GetSection(DefaultConfigSectionName); | ||
|
|
||
| var settings = new AzureAppConfigurationSettings(); | ||
| configSection.Bind(settings); | ||
|
|
||
| if (builder.Configuration.GetConnectionString(connectionName) is string connectionString) | ||
| { | ||
| ((IConnectionStringSettings)settings).ParseConnectionString(connectionString); | ||
| } | ||
|
|
||
| configureSettings?.Invoke(settings); | ||
|
|
||
| if (settings.Endpoint is null) | ||
| { | ||
| throw new InvalidOperationException($"Endpoint is missing. It should be provided in 'ConnectionStrings:{connectionName}' or under the 'Endpoint' key in the '{DefaultConfigSectionName}' configuration section."); | ||
| } | ||
|
|
||
| builder.Configuration.AddAzureAppConfiguration( | ||
| options => | ||
| { | ||
| options.Connect(settings.Endpoint, settings.Credential ?? new DefaultAzureCredential()); | ||
| configureOptions?.Invoke(options); | ||
| }, | ||
| optional); | ||
|
|
||
| builder.Services.AddAzureAppConfiguration(); // register IConfigurationRefresherProvider service | ||
|
|
||
| if (!settings.DisableTracing) | ||
| { | ||
| // WIP: https://github.com/Azure/AppConfiguration-DotnetProvider/pull/645 | ||
| // Will be supported in the next 8.2.0 release | ||
| builder.Services.AddOpenTelemetry() | ||
| .WithTracing(traceBuilder => | ||
| traceBuilder.AddSource(["Microsoft.Extensions.Configuration.AzureAppConfiguration"])); | ||
| } | ||
| } | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| // Licensed to the .NET Foundation under one or more agreements. | ||
| // The .NET Foundation licenses this file to you under the MIT license. | ||
|
|
||
| using Aspire; | ||
| using Aspire.Azure.AppConfiguration; | ||
|
|
||
| [assembly: ConfigurationSchema("Aspire:Azure:AppConfiguration", typeof(AzureAppConfigurationSettings))] | ||
|
|
||
| [assembly: LoggingCategories( | ||
| "Microsoft.Extensions.Configuration.AzureAppConfiguration.Refresh")] |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| // Licensed to the .NET Foundation under one or more agreements. | ||
| // The .NET Foundation licenses this file to you under the MIT license. | ||
|
|
||
| using Aspire.Azure.Common; | ||
| using Azure.Core; | ||
|
|
||
| namespace Aspire.Azure.AppConfiguration; | ||
|
|
||
| /// <summary> | ||
| /// Provides the client configuration settings for connecting to Azure App Configuration. | ||
| /// </summary> | ||
| public sealed class AzureAppConfigurationSettings : IConnectionStringSettings | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| { | ||
| /// <summary> | ||
| /// A <see cref="Uri"/> to the App Config store on which the client operates. Appears as "Endpoint" in the Azure portal. | ||
zhiyuanliang-ms marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| /// This is likely to be similar to "https://{store_name}.azconfig.io". | ||
| /// </summary> | ||
| public Uri? Endpoint { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets or sets the credential used to authenticate to the Azure App Configuration. | ||
| /// </summary> | ||
| public TokenCredential? Credential { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets or sets a boolean value that indicates whether the OpenTelemetry tracing is disabled or not. | ||
| /// </summary> | ||
| /// <value> | ||
| /// The default value is <see langword="false"/>. | ||
| /// </value> | ||
| public bool DisableTracing { get; set; } | ||
|
|
||
| void IConnectionStringSettings.ParseConnectionString(string? connectionString) | ||
| { | ||
| if (!string.IsNullOrEmpty(connectionString) && | ||
| Uri.TryCreate(connectionString, UriKind.Absolute, out var uri)) | ||
| { | ||
| Endpoint = uri; | ||
| } | ||
| } | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,40 @@ | ||
| { | ||
| "definitions": { | ||
| "logLevel": { | ||
| "properties": { | ||
| "Microsoft.Extensions.Configuration.AzureAppConfiguration.Refresh": { | ||
| "$ref": "#/definitions/logLevelThreshold" | ||
| } | ||
| } | ||
| } | ||
| }, | ||
| "type": "object", | ||
| "properties": { | ||
| "Aspire": { | ||
| "type": "object", | ||
| "properties": { | ||
| "Azure": { | ||
| "type": "object", | ||
| "properties": { | ||
| "AppConfiguration": { | ||
| "type": "object", | ||
| "properties": { | ||
| "DisableTracing": { | ||
| "type": "boolean", | ||
| "description": "Gets or sets a boolean value that indicates whether the OpenTelemetry tracing is disabled or not.", | ||
| "default": false | ||
| }, | ||
| "Endpoint": { | ||
| "type": "string", | ||
| "format": "uri", | ||
| "description": "A 'System.Uri' to the App Config store on which the client operates. Appears as \"Endpoint\" in the Azure portal. This is likely to be similar to \"https://{store_name}.azconfig.io\"." | ||
| } | ||
| }, | ||
| "description": "Provides the client configuration settings for connecting to Azure App Configuration." | ||
| } | ||
| } | ||
| } | ||
| } | ||
| } | ||
| } | ||
| } |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.