Skip to content

Commit c21e7f2

Browse files
committed
2 parents db7c2ba + a84c7ea commit c21e7f2

118 files changed

Lines changed: 2717 additions & 414 deletions

File tree

Some content is hidden

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

.openpublishing.redirection.json

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2755,6 +2755,11 @@
27552755
"redirect_url": "/azure/azure-portal/azure-portal-supported-browsers-devices",
27562756
"redirect_document_id": false
27572757
},
2758+
{
2759+
"source_path_from_root": "/articles/azure-resource-manager/bicep/deploy-vscode.md",
2760+
"redirect_url": "/azure/azure-resource-manager/bicep/deploy-visual-studio-code",
2761+
"redirect_document_id": false
2762+
},
27582763
{
27592764
"source_path_from_root": "/articles/azure-resource-manager/management/control-plane-metrics.md",
27602765
"redirect_url": "/azure/azure-resource-manager/management/monitor-resource-manager",
@@ -6894,6 +6899,11 @@
68946899
"source_path": "articles/cyclecloud/how-to/collect-custom-metrics-gpu-infiniband-telegraf.md",
68956900
"redirect_url": "/azure/cyclecloud/how-to/monitor-cyclecloud-cluster-using-prometheus-grafana",
68966901
"redirect_document_id": false
6897-
}
6902+
},
6903+
{
6904+
"source_path": "articles/application-gateway/for-containers/quickstart-deploy-application-gateway-for-containers-alb-controller.md",
6905+
"redirect_url": "/azure/application-gateway/for-containers/quickstart-deploy-application-gateway-for-containers-alb-controller-addon",
6906+
"redirect_document_id": false
6907+
}
68986908
]
68996909
}

articles/api-management/breaking-changes/managed-certificates-suspension-august-2025.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66
ms.service: azure-api-management
77
ms.topic: reference
88
ai-usage: ai-assisted
9-
ms.date: 01/26/2026
9+
ms.date: 02/06/2026
1010
ms.author: danlep
1111
---
1212

@@ -36,11 +36,37 @@ If you need to add new managed certificates, plan to do so before August 15, 202
3636

3737
If you already have managed certificates for your custom domains, do the following to ensure continued access:
3838

39-
- Ensure that your API Management service allows [inbound traffic from DigiCert IP addresses on port 80](#allow-access-to-digicert-ip-addresses). This access is now required for the certificate autorenewal process.
39+
1. Ensure that your API Management service [allows inbound traffic from DigiCert IP addresses on port 80](#step-1-allow-access-to-digicert-ip-addresses). This access is now required for the certificate autorenewal process.
40+
1. [Configure DNS records](#step-2-configure-dns-records) to resolve your custom domain name.
41+
1. [Allow API Management service access to port 80](#step-3-allow-api-management-service-access-to-port-80) if you have inbound network restrictions in place.
4042

43+
### Step 1: Allow access to DigiCert IP addresses
4144

4245
[!INCLUDE [api-management-managed-certificate-ip-access.md](../../../includes/api-management-managed-certificate-ip-access.md)]
4346

47+
### Step 2: Configure DNS records
48+
49+
Configure DNS records for your custom domain to point to your API Management gateway. The type of DNS record you need to add depends on your API Management tier.
50+
51+
#### DNS records for Developer, Basic, Standard, or Premium tier
52+
53+
1. Add either a [CNAME](/azure/api-management/configure-custom-domain?tabs=custom#cname-record) or A-record with your DNS provider.
54+
55+
1. Add DigiCert as an authorized certificate authority (CA) in Azure DNS. For this, create a specific CAA record set within your domain's DNS zone using the Azure portal or other management tools.
56+
57+
#### DNS records for Consumption tier
58+
59+
1. Add either a [CNAME](/azure/api-management/configure-custom-domain?tabs=custom#cname-record) or [TXT](/azure/api-management/configure-custom-domain?tabs=managed#txt-record) record with your DNS provider. If you configure both, the TXT record takes precedence.
60+
1. Add DigiCert as an authorized certificate authority (CA) in Azure DNS. For this, you need to create a specific CAA record set within your domain's DNS zone using the Azure portal or other management tools
61+
62+
### Step 3: Allow API Management service access to port 80
63+
64+
If you have inbound network restrictions configured for your API Management service, allow the Azure API Management resource provider access on port 80. This is required to allow inbound traffic to support certificate revocation list (CRL) checks, certificate renewal, and management communication.
65+
66+
1. In the Azure portal, go to **Network security groups**.
67+
1. Select the network security group associated with your API Management subnet.
68+
1. Under **Settings** > **Inbound security rules**, add a new rule allowing traffic on port 80 from the **ApiManagement** service tag to the API Management instance.
69+
4470
## Help and support
4571

4672
If you have questions, get answers from community experts in [Microsoft Q&A](https://aka.ms/apim/azureqa/change/captcha-2022). If you have a support plan and need technical help, create a [support request](https://portal.azure.com/#view/Microsoft_Azure_Support/HelpAndSupportBlade/~/overview).

articles/api-management/breaking-changes/trusted-service-connectivity-retirement-march-2026.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ First, check for an Azure Advisor recommendation:
3131

3232
**If you don't see a recommendation**, your API Management gateway isn't affected by the change.
3333

34-
**If you see a recommendation**, your API Management gateway is affected by the breaking change and you need to take action:
34+
**If you see a recommendation**, your API Management gateway has previously sent traffic to the listed Azure services. Because of this, it is considered affected by the breaking change and you need to take action:
3535

3636
1. Determine if your API Management gateway relies on trusted service connectivity to Azure services.
3737
1. If it does, update the networking configuration to eliminate the dependency on trusted service connectivity. If it doesn’t, proceed to the next step.

articles/api-management/configure-custom-domain.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,8 @@ API Management offers a free, managed TLS certificate for your domain, if you do
126126
* Supports only public domain names
127127
* Can only be configured when updating an existing API Management instance, not when creating an instance
128128

129+
### Allow access to DigiCert IP addresses
130+
129131
[!INCLUDE [api-management-managed-certificate-ip-access.md](../../includes/api-management-managed-certificate-ip-access.md)]
130132

131133
---

articles/api-management/import-soap-api.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
22
title: Import SOAP API to Azure API Management | Microsoft Docs
3-
description: Learn how to import a SOAP API to Azure API Management as a WSDL specification using the Azure portal, Azure CLI, or Azure PowerShell. Then, test the API in the Azure portal.
3+
description: Learn how to import a SOAP API to Azure API Management as a WSDL specification using the Azure portal, Azure CLI, or Azure PowerShell. Then, test the API.
44
author: dlepow
55
ms.service: azure-api-management
66
ms.custom: devx-track-azurepowershell, devx-track-azurecli
77
ms.topic: how-to
8-
ms.date: 11/05/2024
8+
ms.date: 02/02/2026
99
ms.author: danlep
10+
#customer intent: As an API developer, I want to import the WSDL specification for an API by using the best tool for my workflow.
1011
---
1112
# Import SOAP API to API Management
1213

@@ -17,23 +18,18 @@ This article shows how to import a WSDL specification, which is a standard XML r
1718
In this article, you learn how to:
1819

1920
> [!div class="checklist"]
20-
> * Import a SOAP API
21-
> * Test the API in the Azure portal
21+
> - Import a SOAP API
22+
> - Test the API in the Azure portal
2223
2324
[!INCLUDE [api-management-wsdl-import](../../includes/api-management-wsdl-import.md)]
2425

2526
## Prerequisites
2627

27-
* An API Management instance. If you don't already have one, complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md).
28-
29-
* Azure CLI
28+
- An API Management instance. If you don't already have one, complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md).
29+
- Azure CLI
3030
[!INCLUDE [azure-cli-prepare-your-environment-no-header.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
31-
32-
33-
* Azure PowerShell
31+
- Azure PowerShell
3432
[!INCLUDE [azure-powershell-requirements-no-header](~/reusable-content/ce-skilling/azure/includes/azure-powershell-requirements-no-header.md)]
35-
36-
3733

3834
## <a name="create-api"> </a>Import a backend API
3935

@@ -43,16 +39,20 @@ In this article, you learn how to:
4339
1. In the left menu, select **APIs** > **+ Add API**.
4440
1. Under **Create from definition**, select **WSDL**.
4541

46-
![SOAP API](./media/import-soap-api/wsdl-api.png)
47-
1. In **WSDL specification**, enter the URL to your SOAP API, or click **Select a file** to select a local WSDL file.
42+
:::image type="content" source="./media/import-soap-api/wsdl-api.png" alt-text="Screenshot shows the WSDL tile for importing your SOAP API.":::
43+
44+
1. In **WSDL specification**, enter the URL to your SOAP API, or choose **Select a file** to select a local WSDL file.
4845
1. In **Import method**, **SOAP pass-through** is selected by default.
49-
With this selection, the API is exposed as SOAP, and API consumers have to use SOAP rules. If you want to "restify" the API, follow the steps in [Import a SOAP API and convert it to REST](restify-soap-api.md).
5046

51-
![Create SOAP API from WSDL specification](./media/import-soap-api/pass-through.png)
47+
With this selection, the API is exposed as SOAP, and API consumers have to use SOAP rules. If you want to "restify" the API, follow the steps in [Import a SOAP API and convert it to REST](restify-soap-api.md).
48+
49+
:::image type="content" source="./media/import-soap-api/pass-through.png" alt-text="Screenshot shows the Create from WSDL page.":::
50+
5251
1. The following API settings are filled automatically based on information from the SOAP API: **Display name**, **Name**, **Description**. Operations are filled automatically with **Display name**, **URL**, and **Description**, and receive a system-generated **Name**.
5352
1. Enter other API settings. You can set the values during creation or configure them later by going to the **Settings** tab.
5453

55-
For more information about API settings, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
54+
For more information about API settings, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
55+
5656
1. Select **Create**.
5757

5858
#### [Azure CLI](#tab/cli)
@@ -113,20 +113,18 @@ Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $
113113

114114
## Wildcard SOAP action
115115

116-
If you need to pass a SOAP request that doesn't have a dedicated action defined in the API, you can configure a wildcard SOAP action. The wildcard action will match any SOAP request that isn't defined in the API.
116+
If you need to pass a SOAP request that doesn't have a dedicated action defined in the API, you can configure a wildcard SOAP action. The wildcard action matches any SOAP request that isn't defined in the API.
117117

118118
To define a wildcard SOAP action:
119119

120-
1. In the portal, select the API you created in the previous step.
120+
1. In the Azure portal, select the API you created in the previous step.
121121
1. In the **Design** tab, select **+ Add Operation**.
122122
1. Enter a **Display name** for the operation.
123-
1. In the URL, select `POST` and enter `/?soapAction={any}` in the resource. The template parameter inside the curly brackets is arbitrary and doesn't affect the execution.
123+
1. In the URL, select `POST` and enter `/?soapAction={any}` in the resource. The template parameter inside the braces is arbitrary and doesn't affect the execution.
124124

125125
> [!NOTE]
126126
> Don't use the **OpenAPI specification** editor in the **Design** tab to modify a SOAP API.
127127
128-
129-
130128
[!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-append-apis.md)]
131129

132130
[!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]
18.5 KB
Loading

articles/app-service/tutorial-multi-region-app.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to build a multi-region app on Azure App Service that can
44
keywords: azure app service, web app, multiregion, multi-region, multiple regions
55
author: seligj95
66
ms.topic: tutorial
7-
ms.date: 2/8/2023
7+
ms.date: 02/08/2023
88
ms.author: jordanselig
99
ms.service: azure-app-service
1010
ms.custom:
@@ -418,10 +418,10 @@ Now that you have a service principal that can access your App Service apps, edi
418418
runs-on: ubuntu-latest
419419

420420
steps:
421-
- uses: actions/checkout@v2
421+
- uses: actions/checkout@v4
422422

423423
- name: Set up Node.js version
424-
uses: actions/setup-node@v1
424+
uses: actions/setup-node@v4
425425
with:
426426
node-version: ${{ env.NODE_VERSION }}
427427

@@ -431,7 +431,7 @@ Now that you have a service principal that can access your App Service apps, edi
431431
npm run build --if-present
432432

433433
- name: Upload artifact for deployment job
434-
uses: actions/upload-artifact@v2
434+
uses: actions/upload-artifact@v4
435435
with:
436436
name: node-app
437437
path: .
@@ -445,11 +445,11 @@ Now that you have a service principal that can access your App Service apps, edi
445445

446446
steps:
447447
- name: Download artifact from build job
448-
uses: actions/download-artifact@v2
448+
uses: actions/download-artifact@v4
449449
with:
450450
name: node-app
451451

452-
- uses: azure/login@v1
452+
- uses: azure/login@v2
453453
with:
454454
creds: |
455455
{
@@ -461,7 +461,7 @@ Now that you have a service principal that can access your App Service apps, edi
461461

462462
- name: 'Deploy to Azure Web App'
463463
id: deploy-to-webapp
464-
uses: azure/webapps-deploy@v2
464+
uses: azure/webapps-deploy@v3
465465
with:
466466
app-name: ${{ env.AZURE_WEBAPP_NAME }}
467467
slot-name: ${{ env.AZURE_WEBAPP_SLOT_NAME }}

articles/application-gateway/for-containers/alb-controller-release-notes.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: application-gateway
55
author: mbender-ms
66
ms.service: azure-appgw-for-containers
77
ms.topic: release-notes
8-
ms.date: 1/28/2026
8+
ms.date: 2/7/2026
99
ms.author: mbender
1010
# Customer intent: As a Kubernetes operator, I want to access the release notes for the ALB Controller, so that I can understand the latest updates and changes to optimize my configuration and deployments of Application Gateway for Containers.
1111
---
@@ -18,21 +18,24 @@ The ALB Controller is a Kubernetes deployment that orchestrates configuration an
1818

1919
Each release of ALB Controller has a documented helm chart version and supported Kubernetes cluster version.
2020

21-
Instructions for new or existing deployments of ALB Controller are found in the following links:
21+
Instructions for new or existing deployments of ALB Controller deployed with helm are found in the following links:
2222

23-
- [New deployment of ALB Controller](quickstart-deploy-application-gateway-for-containers-alb-controller.md#for-new-deployments)
24-
- [Upgrade existing ALB Controller](quickstart-deploy-application-gateway-for-containers-alb-controller.md#for-existing-deployments)
23+
- [New deployment of ALB Controller with helm](quickstart-deploy-application-gateway-for-containers-alb-controller-helm.md#for-new-deployments)
24+
- [Upgrade existing ALB Controller with helm](quickstart-deploy-application-gateway-for-containers-alb-controller-helm.md#for-existing-deployments)
25+
26+
If using the AKS add-on, updates will automatically be applied to the cluster.
2527

2628
## Latest Release (Recommended)
2729

2830
| ALB Controller Version | Gateway API Version | Minimum Kubernetes Version | Release Notes |
2931
| ---------------------- | ------------------- | ------------------ | ------------- |
30-
| 1.9.11 | v1.2.1 | v1.27 | [allowPrivilegeEscalation false](https://github.com/Azure/AKS/issues/5389), [Integration with AKS Istio Service Mesh Add-on](https://github.com/Azure/AKS/issues/5479), [fix for NAP with Karpenter](https://github.com/Azure/AKS/issues/5486), general image updates |
32+
| 1.9.13 | v1.2.1 | v1.27 | Concurrency-related pod crash fix, security updates |
3133

3234
## Release history
3335

3436
| ALB Controller Version | Gateway API Version | Minimum Kubernetes Version | Release Notes |
3537
| ---------------------- | ------------------- | ------------------ | ------------- |
38+
| 1.9.11 | v1.2.1 | v1.27 | [allowPrivilegeEscalation false](https://github.com/Azure/AKS/issues/5389), [Integration with AKS Istio Service Mesh Add-on](https://github.com/Azure/AKS/issues/5479), [fix for NAP with Karpenter](https://github.com/Azure/AKS/issues/5486), general image updates |
3639
| 1.8.12 | v1.2.1 | v1.27 | WAF improvements |
3740
| 1.8.9 | v1.2.1 | v1.27 | [Slow start load balancing algorithm](api-specification-kubernetes.md#alb.networking.azure.io/v1.BackendLoadBalancingPolicy), Image updated to use [Azure Linux 3.0](https://github.com/microsoft/azurelinux), [nodeSelector fix](https://github.com/Azure/AKS/issues/5302), miscellaneous bug fixes and enhancements |
3841
| 1.7.12 | v1.2.1 | v1.27 | Hotfix for pod crash due to [invalid Provider ID](https://github.com/Azure/AKS/issues/5310) |

articles/application-gateway/for-containers/application-gateway-for-containers-components.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,18 @@ This article provides detailed descriptions and requirements for components of A
5757
- At this time, the only security policy type offered is `waf` for web application firewall capabilities.
5858
- The `waf` security policy is a one-to-one mapping between the security policy resource and a Web Application Firewall policy.
5959
- You can reference only one web application firewall policy in any number of security policies for a defined Application Gateway for Containers resource.
60+
61+
### Application Gateway for Containers AKS managed add-on
62+
63+
The AKS add-on for Application Gateway for Containers provides a managed deployment experience by AKS for the ALB Controller, eliminating the need to manually deploy a helm chart.
64+
65+
Some of the benefits of using the managed add-on over a helm based deployment are:
66+
67+
- **Managed updates:** No need to manually update Helm charts; updates are managed by AKS.
68+
- **Automated identity management:** The add-on automatically creates and configures the managed identity (`applicationloadbalancer-<cluster-name>`) with the required permissions.
69+
- **Simplified subnet configuration:** A dedicated subnet (`aks-appgateway`) is automatically provisioned with the correct delegation.
70+
- **Reduced configuration complexity:** No need to manually set up federated credentials or role assignments.
71+
- **AKS Automatic support:** Add-on deployment is required when using AKS Automatic clusters.
6072

6173
## Azure / general concepts
6274

@@ -125,4 +137,4 @@ Application Gateway for Containers enforces the following timeouts as it initiat
125137
| Upstream Connect Timeout | 5 seconds | Time for establishing a connection to the backend target. |
126138

127139
> [!NOTE]
128-
> Request timeout strictly enforces the request to complete in the defined time irrespective if data is actively streaming or the request is idle. For example, if you're serving large file downloads and you expect transfers to take greater than 60 seconds due to size or slow transfer rates, consider increasing the request timeout value or setting it to 0.
140+
> Request timeout strictly enforces the request to complete in the defined time irrespective if data is actively streaming or the request is idle. For example, if you're serving large file downloads and you expect transfers to take greater than 60 seconds due to size or slow transfer rates, consider increasing the request timeout value or setting it to 0.

articles/application-gateway/for-containers/container-networking.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,7 @@ A: Yes, however, installation of Application Gateway for Containers on a cluster
7878

7979
## Next steps
8080

81-
* [Deploy ALB Controller](quickstart-deploy-application-gateway-for-containers-alb-controller.md?tabs=install-helm-windows)
81+
* [Deploy ALB Controller - Add-on](quickstart-deploy-application-gateway-for-containers-alb-controller-addon.md)
82+
* [Deploy ALB Controller - Helm](quickstart-deploy-application-gateway-for-containers-alb-controller-helm.md)
8283
* [Application Gateway for Containers components](application-gateway-for-containers-components.md)
8384
* [Upgrade AKS to CNI Overlay](/azure/aks/upgrade-aks-ipam-and-dataplane#upgrade-an-existing-cluster-to-azure-cni-overlay)

0 commit comments

Comments
 (0)