Skip to content

Commit d1eda45

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into azure-hdinsight-articles
2 parents 5c4f02c + e2e1f04 commit d1eda45

File tree

557 files changed

+3885
-2239
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

557 files changed

+3885
-2239
lines changed

.github/policies/disallow-edits.yml

Lines changed: 71 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ configuration:
1010
- payloadType: Pull_Request
1111
- isAction:
1212
action: Opened
13-
- or:
13+
- or:
1414
- filesMatchPattern:
1515
matchAny: true
1616
pattern: articles/aks/*
@@ -121,4 +121,74 @@ configuration:
121121
reply: >-
122122
@${issueAuthor} - You tried to add content to a folder path that has been removed from this repository. Your pull request will be automatically closed. Submit your changes to the updated repository, which can be identified by clicking the Edit this Document link at the top of any published article for that product or service.
123123
- closePullRequest
124+
125+
- description: Alert authors to edits in the /articles/reliability folder.
126+
if:
127+
# If a PR in the articles/reliability folder is opened, and the PR author isn't Anastasia or John...
128+
- payloadType: Pull_Request
129+
- filesMatchPattern:
130+
matchAny: true
131+
pattern: articles/reliability/*
132+
- isAction:
133+
action: Opened
134+
- not:
135+
or:
136+
- isActivitySender:
137+
user: anaharris-ms
138+
- isActivitySender:
139+
user: johndowns
140+
then:
141+
# Mention Anastasia and John, add a reply asking the PR author not to sign off on the PR, and add the needs-human-review label.
142+
- mentionUsers:
143+
mentionees:
144+
- anaharris-ms
145+
- johndowns
146+
replyTemplate: >-
147+
Tagging authors for this folder: ${mentionees}
148+
- addReply:
149+
reply: >-
150+
@${issueAuthor} - Please do NOT sign off on this pull request. The Reliability Hub owners will sign off for you.
151+
- addLabel:
152+
label: needs-human-review
153+
154+
- description: Disallow sign-off for articles in the /articles/reliability folder.
155+
if:
156+
# If a 'sign-off' comment is added to a PR in the articles/reliability folder , and the PR author isn't Anastasia or John...
157+
- payloadType: Issue_Comment
158+
- isPullRequest
159+
- filesMatchPattern:
160+
matchAny: true
161+
pattern: articles/reliability/*
162+
- commentContains:
163+
pattern: \#sign-off
164+
isRegex: false
165+
- not:
166+
or:
167+
- isActivitySender:
168+
user: anaharris-ms
169+
- isActivitySender:
170+
user: johndowns
171+
then:
172+
# Add the do-not-merge label, remove the ready-to-merge label, and add a reply asking the PR author not to sign off on the PR.
173+
- addReply:
174+
reply: >-
175+
@${issueAuthor} - Please do NOT sign off on this pull request. The Reliability Hub owners will sign off for you.
176+
- addLabel:
177+
label: do-not-merge
178+
- removeLabel:
179+
label: ready-to-merge
180+
181+
- description: Write a message if the breadcrumb file is modified in the azure-docs-pr repository.
182+
if:
183+
- payloadType: Pull_Request
184+
- isAction:
185+
action: Opened
186+
- filesMatchPattern:
187+
matchAny: true
188+
pattern: bread/*
189+
190+
then:
191+
- addReply:
192+
reply: >-
193+
@${issueAuthor} - This PR modifies the breadcrumb file for the entire repository: bread/toc.yml. This file supports the on-site navigation for 100s of services. Please make sure your changes to the breadcrumb file are intentional. Do not delete this file.
124194

.github/workflows/stale.yml

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
name: Mark stale pull requests
2+
3+
permissions:
4+
issues: write
5+
pull-requests: write
6+
7+
on:
8+
schedule:
9+
- cron: "0 */6 * * *"
10+
11+
jobs:
12+
stale:
13+
14+
runs-on: ubuntu-latest
15+
16+
steps:
17+
- uses: actions/stale@v3
18+
with:
19+
repo-token: ${{ secrets.GITHUB_TOKEN }}
20+
days-before-pr-stale: 14
21+
days-before-pr-close: 90
22+
stale-pr-label: inactive
23+
close-pr-label: auto-close
24+
exempt-pr-labels: keep-open
25+
operations-per-run: 1300
26+
ascending: false
27+
# start-date: '2021-03-19'
28+
stale-pr-message: >
29+
This pull request has been inactive for at least 14 days.
30+
31+
If you are finished with your changes, don't forget to sign off. See the [platform guide](https://review.learn.microsoft.com/help/platform/prmerger-hashtag-commands?branch=main) for instructions.
32+
33+
[Get Help](https://review.learn.microsoft.com/help/platform/help-options?branch=main)
34+
35+
[Learn Support Teams Channel](https://teams.microsoft.com/l/channel/19%3a7ecffca1166a4a3986fed528cf0870ee%40thread.skype/General?groupId=de9ddba4-2574-4830-87ed-41668c07a1ca&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47)
36+
37+
[Resolve Merge Conflicts](https://review.learn.microsoft.com/help/contribute/resolve-merge-conflicts?branch=main)
38+
close-pr-message: >
39+
This pull request has been inactive for 90 days, and an `auto-close` label has been added. At this time, the system is closing the PR automatically. If you decide to continue working on your changes, scroll to the bottom of the pull request comments and select the **Reopen pull request** button.
40+
<br/>

articles/app-service/configure-authentication-file-based.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ The following exhausts possible configuration options within the file:
8181
"url_scheme_of_your_app://easyauth.callback"
8282
],
8383
"cookieExpiration": {
84-
"convention": "FixedTime|IdentityDerived",
84+
"convention": "FixedTime|IdentityProviderDerived",
8585
"timeToExpiration": "<timespan>"
8686
},
8787
"nonce": {

articles/app-service/configure-language-python.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,9 @@ This article describes how [Azure App Service](overview.md) runs Python apps, ho
1919

2020
The App Service deployment engine automatically activates a virtual environment and runs `pip install -r requirements.txt` for you when you deploy a [Git repository](deploy-local-git.md), or when you deploy a [zip package](deploy-zip.md) [with build automation enabled](deploy-zip.md#enable-build-automation-for-zip-deploy).
2121

22+
> [!NOTE]
23+
> Currently App Service requires `requirements.txt` in your project's root directory, even if you're using modern Python packaging tools such as `pyproject.toml`.
24+
2225
This guide provides key concepts and instructions for Python developers who use a built-in Linux container in App Service. If you've never used Azure App Service, first follow the [Python quickstart](quickstart-python.md) and [Flask](tutorial-python-postgresql-app-flask.md), [Django](tutorial-python-postgresql-app-django.md), or [FastAPI](tutorial-python-postgresql-app-fastapi.md) with PostgreSQL tutorial.
2326

2427
You can use either the [Azure portal](https://portal.azure.com) or the Azure CLI for configuration:
2.67 KB
Loading
5.98 KB
Loading
-78.7 KB
Loading
-924 Bytes
Loading

articles/azure-app-configuration/TOC.yml

Lines changed: 39 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -302,28 +302,47 @@
302302
href: ./rest-api-versioning.md
303303
- name: Client libraries
304304
items:
305-
- name: .NET provider
306-
href: /dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration
307-
- name: .NET Framework builder
308-
href: https://go.microsoft.com/fwlink/?linkid=2074663
309-
- name: Java Spring provider
310-
href: https://go.microsoft.com/fwlink/?linkid=2180917
311-
- name: Python provider
312-
href: https://pypi.org/project/azure-appconfiguration-provider/
313-
- name: JavaScript provider
314-
href: ./reference-javascript-provider.md
315-
- name: Azure SDK for .NET
316-
href: https://go.microsoft.com/fwlink/?linkid=2092056
317-
- name: Azure SDK for Java
318-
href: https://go.microsoft.com/fwlink/?linkid=2098196
319-
- name: Azure SDK for Python
320-
href: https://go.microsoft.com/fwlink/?linkid=2103727
321-
- name: Azure SDK for JavaScript
322-
href: https://go.microsoft.com/fwlink/?linkid=2103664
323-
- name: Azure SDK for Go
324-
href: https://go.microsoft.com/fwlink/?linkid=2270866
305+
- name: Overview
306+
href: ./configuration-provider-overview.md
307+
- name: .NET
308+
items:
309+
- name: API reference
310+
href: /dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration
311+
- name: Azure SDK for .NET
312+
href: https://go.microsoft.com/fwlink/?linkid=2092056
313+
- name: .NET Framework builder
314+
href: https://go.microsoft.com/fwlink/?linkid=2074663
315+
- name: Java Spring
316+
items:
317+
- name: Feature reference
318+
href: https://go.microsoft.com/fwlink/?linkid=2180917
319+
- name: Azure SDK for Java
320+
href: https://go.microsoft.com/fwlink/?linkid=2098196
321+
- name: Python
322+
items:
323+
- name: Feature reference
324+
href: https://pypi.org/project/azure-appconfiguration-provider/
325+
- name: Azure SDK for Python
326+
href: https://go.microsoft.com/fwlink/?linkid=2103727
327+
- name: JavaScript
328+
items:
329+
- name: Feature reference
330+
href: ./reference-javascript-provider.md
331+
- name: Azure SDK for JavaScript
332+
href: https://go.microsoft.com/fwlink/?linkid=2103664
333+
- name: Kubernetes
334+
items:
335+
- name: Feature reference
336+
href: ./reference-kubernetes-provider.md
337+
- name: Go
338+
items:
339+
- name: Azure SDK for Go
340+
href: https://go.microsoft.com/fwlink/?linkid=2270866
341+
325342
- name: Feature management
326343
items:
344+
- name: Overview
345+
href: ./feature-management-overview.md
327346
- name: .NET
328347
items:
329348
- name: Feature reference
@@ -352,8 +371,6 @@
352371
href: /cli/azure/appconfig
353372
- name: Azure PowerShell
354373
href: /powershell/module/az.appconfiguration/
355-
- name: Kubernetes provider
356-
href: reference-kubernetes-provider.md
357374
- name: Azure Policy built-ins
358375
displayName: samples, policies, definitions
359376
href: ./policy-reference.md
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: Configuration Provider Overview
3+
titleSuffix: Azure App Configuration
4+
description: Overview of configuration provider libraries of different programming languages.
5+
services: azure-app-configuration
6+
author: zhiyuanliang-ms
7+
ms.author: zhiyuanliang
8+
ms.service: azure-app-configuration
9+
ms.topic: overview
10+
ms.date: 01/22/2025
11+
#Customer intent: I want to learn about the configuration provider libraries of different languages, specifically to track their feature development status.
12+
---
13+
14+
# Configuration Provider Overview
15+
16+
The Azure App Configuration provider libraries enable developers to configure their applications using centralized configuration located in Azure App Configuration. The API design follows the patterns outlined by the common configuration system in different programming languages to make switching to Azure App Configuration a familiar and easy experience.
17+
18+
> [!IMPORTANT]
19+
> The configuration provider libraries are higher-level integration libraries that support additional [features](#feature-development-status) in contrast to the Azure SDKs which provide low-level, direct interaction with the Azure App Configuration service.
20+
21+
> [!NOTE]
22+
> If you use feature flags in Azure App Configuration, we recommend you to use the configuration provider alongside the [feature management](./feature-management-overview.md) libraries, which are designed to work together.
23+
24+
## Configuration Provider Libraries
25+
26+
Module | Platform | Sample | Release Notes
27+
------ | -------- | ------ | -------------
28+
[Microsoft.Extensions.Configuration.AzureAppConfiguration](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Extensions.Configuration.AzureAppConfiguration](https://img.shields.io/nuget/v/Microsoft.Extensions.Configuration.AzureAppConfiguration.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.AzureAppConfiguration/) | .NET Standard | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftExtensionsConfigurationAzureAppConfiguration.md)
29+
[Microsoft.Azure.AppConfiguration.AspNetCore](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Azure.AppConfiguration.AspNetCore](https://img.shields.io/nuget/v/Microsoft.Azure.AppConfiguration.AspNetCore.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore/) | ASP&#46;NET Core | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftAzureAppConfigurationAspNetCore.md)
30+
[Microsoft.Azure.AppConfiguration.Functions.Worker](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Azure.AppConfiguration.Functions.Worker](https://img.shields.io/nuget/v/Microsoft.Azure.AppConfiguration.Functions.Worker.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.Functions.Worker/) | Azure Functions<br/>(Isolated process) | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore/AzureFunction/FunctionAppIsolatedMode) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftAzureAppConfigurationFunctionsWorker.md)
31+
[Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration](https://github.com/aspnet/MicrosoftConfigurationBuilders/tree/main/src/AzureAppConfig)<br/>[![Nuget: Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration](https://img.shields.io/nuget/v/Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration/) | .NET Framework | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetFramework/WebDemo) | [Release Notes](https://github.com/aspnet/MicrosoftConfigurationBuilders/releases)
32+
[spring-cloud-azure-appconfiguration-config](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-appconfiguration-config)<br/>[![Maven: spring-cloud-azure-appconfiguration-config](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-appconfiguration-config.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-appconfiguration-config) | Java Spring | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-starter-appconfiguration-config/spring-cloud-azure-starter-appconfiguration-config-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureAppConfigurationConfig.md)
33+
[spring-cloud-azure-appconfiguration-config-web](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-appconfiguration-config-web)<br/>[![Maven: spring-cloud-azure-appconfiguration-config-web](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-appconfiguration-config-web.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-appconfiguration-config-web) | Java Spring | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-starter-appconfiguration-config/spring-cloud-azure-starter-appconfiguration-config-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureAppConfigurationConfig.md)
34+
[azure-appconfiguration-provider](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration-provider)<br/>[![Pypi](https://img.shields.io/pypi/v/azure-appconfiguration-provider.svg?color=blue)](https://pypi.org/project/azure-appconfiguration-provider/) | Python | [Sample](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration-provider/samples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/AzureAppConfigurationProviderPython.md)
35+
[@azure/app-configuration-provider](https://github.com/Azure/AppConfiguration-JavaScriptProvider)<br/>[![Npm](https://img.shields.io/npm/v/@azure/app-configuration-provider?color=blue)](https://www.npmjs.com/package/@azure/app-configuration-provider) | JavaScript | [Sample](https://github.com/Azure/AppConfiguration-JavaScriptProvider/tree/main/examples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/JavaScriptProvider.md)
36+
37+
## Feature Development Status
38+
39+
This is an overview of each feature and its current status for different frameworks or programming languages.
40+
41+
- **GA (General Availability)**: The feature is fully released, considered stable, and ready for production use.
42+
- **Preview**: The feature is available for early testing and feedback, but not yet fully stable or recommended for production use.
43+
- **WIP (Work in Progress)**: The feature is actively being developed and not yet ready for release.
44+
- **N/A (Not Available)**: It is not planned to offer the feature for the specified framework or language.
45+
46+
Feature | .NET | Spring | Kubernetes | Python | JavaScript
47+
------- | ---- | ------ | ---------- | ------ | ----------
48+
Connection String Authentication | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#load-configuration)
49+
Entra ID Authentication | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#load-configuration)
50+
Dynamic Refresh (Poll Mode) | GA | GA | GA | GA | GA
51+
Dynamic Refresh (Push Mode) | GA | GA | N/A | N/A | N/A
52+
Dynamic Refresh (Collection Monitoring) | WIP | WIP | GA | WIP | [GA](./reference-javascript-provider.md#configuration-refresh)
53+
JSON Content Type Handling | GA | GA | GA | GA | GA
54+
Configuration Setting Mapping | GA | N/A | N/A | N/A | N/A
55+
Key Vault References | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#key-vault-reference)
56+
Key Vault Secret Refresh | GA | WIP | GA | WIP | WIP
57+
Custom Key Vault Secret Resolution | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#key-vault-reference)
58+
Feature Flags | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#feature-flag)
59+
Variant Feature Flags | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#feature-flag)
60+
Feature Flag Telemetry | GA | GA | WIP | GA | GA
61+
Key Prefix Trim | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#trim-prefix-from-keys)
62+
Configurable Startup Time-out | GA | WIP | N/A | WIP | WIP
63+
Replica Auto Discovery | GA | GA | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
64+
Replica Failover | GA | GA | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
65+
Replica Load Balancing | GA | WIP | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
66+
Snapshots | GA | GA | GA | WIP | WIP

0 commit comments

Comments
 (0)