Skip to content

Commit ddfc726

Browse files
authored
Merge pull request #275145 from MicrosoftDocs/main
Publish to live, Sunday 4:00PM PDT, 05/12
2 parents ba047bf + d9b08f8 commit ddfc726

19 files changed

+492
-104
lines changed

articles/application-gateway/application-gateway-autoscaling-zone-redundant.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,9 @@ Application Gateway and WAF can be configured to scale in two modes:
2222
2323
- **Manual** - You can also choose Manual mode where the gateway doesn't autoscale. In this mode, if there's more traffic than what Application Gateway or WAF can handle, it could result in traffic loss. With manual mode, specifying instance count is mandatory. Instance count can vary from 1 to 125 instances.
2424

25+
> [!NOTE]
26+
> These scaling modes don’t apply for Application Gateway Basic. Application Gateway Basic automatically scales up to an estimated 200 connections per second, based on an RSA 2048-bit key TLS certificate.
27+
2528
## Autoscaling and High Availability
2629

2730
Azure Application Gateways are always deployed in a highly available fashion. The service is made up of multiple instances that are created as configured if autoscaling is disabled, or required by the application load if autoscaling is enabled. From the user's perspective, you don't necessarily have visibility into the individual instances, but just into the Application Gateway service as a whole. If a certain instance has a problem and stops being functional, Azure Application Gateway transparently creates a new instance.

articles/application-gateway/deploy-basic-portal.md

Lines changed: 256 additions & 0 deletions
Large diffs are not rendered by default.
119 KB
Loading
92 KB
Loading

articles/application-gateway/overview-v2.md

Lines changed: 66 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,36 +5,66 @@ services: application-gateway
55
author: greg-lindsay
66
ms.service: application-gateway
77
ms.topic: overview
8-
ms.date: 04/25/2024
8+
ms.date: 04/30/2024
99
ms.author: greglin
1010
ms.custom: references_regions
1111
---
1212

1313
# What is Azure Application Gateway v2?
1414

15-
Application Gateway is available under a Standard_v2 SKU. Web Application Firewall (WAF) is available under a WAF_v2 SKU. The v2 SKU offers performance enhancements and adds support for critical new features like autoscaling, zone redundancy, and support for static VIPs. Existing features under the Standard and WAF SKU continue to be supported in the new v2 SKU, with a few exceptions listed in [comparison](#differences-from-v1-sku) section.
15+
Application Gateway v2 is the latest version of Application Gateway. It provides advantages over Application Gateway v1 such as performance enhancements, autoscaling, zone redundancy, and static VIPs.
1616

17-
The new v2 SKU includes the following enhancements:
17+
> [!IMPORTANT]
18+
> Deprecation of Application Gateway V1 was [announced on April 28, 2023](v1-retirement.md). If you use Application Gateway V1 SKU, start planning your migration to V2 now and complete your migration to Application Gateway v2 by April 28, 2026. The v1 service isn't supported after this date.
19+
20+
## Key capabilities
21+
22+
The v2 SKU includes the following enhancements:
1823

1924
- **TCP/TLS proxy (Preview)**: Azure Application Gateway now also supports Layer 4 (TCP protocol) and TLS (Transport Layer Security) proxying. This feature is currently in public preview. For more information, see [Application Gateway TCP/TLS proxy overview](tcp-tls-proxy-overview.md).
2025
- **Autoscaling**: Application Gateway or WAF deployments under the autoscaling SKU can scale out or in based on changing traffic load patterns. Autoscaling also removes the requirement to choose a deployment size or instance count during provisioning. This SKU offers true elasticity. In the Standard_v2 and WAF_v2 SKU, Application Gateway can operate both in fixed capacity (autoscaling disabled) and in autoscaling enabled mode. Fixed capacity mode is useful for scenarios with consistent and predictable workloads. Autoscaling mode is beneficial in applications that see variance in application traffic.
2126
- **Zone redundancy**: An Application Gateway or WAF deployment can span multiple Availability Zones, removing the need to provision separate Application Gateway instances in each zone with a Traffic Manager. You can choose a single zone or multiple zones where Application Gateway instances are deployed, which makes it more resilient to zone failure. The backend pool for applications can be similarly distributed across availability zones.
2227

2328
Zone redundancy is available only where Azure Zones are available. In other regions, all other features are supported. For more information, see [Regions and Availability Zones in Azure](../reliability/availability-zones-service-support.md)
24-
- **Static VIP**: Application Gateway v2 SKU supports the static VIP type exclusively. This ensures that the VIP associated with the application gateway doesn't change for the lifecycle of the deployment, even after a restart. There isn't a static VIP in v1, so you must use the application gateway URL instead of the IP address to route App Services via the application gateway.
29+
- **Static VIP**: Application Gateway v2 SKU supports the static VIP type exclusively. Static VIP ensures that the VIP associated with the application gateway doesn't change for the lifecycle of the deployment, even after a restart. You must use the application gateway URL for domain name routing to App Services via the application gateway, as v1 doesn't have a static VIP.
2530
- **Header Rewrite**: Application Gateway allows you to add, remove, or update HTTP request and response headers with v2 SKU. For more information, see [Rewrite HTTP headers with Application Gateway](./rewrite-http-headers-url.md)
2631
- **Key Vault Integration**: Application Gateway v2 supports integration with Key Vault for server certificates that are attached to HTTPS enabled listeners. For more information, see [TLS termination with Key Vault certificates](key-vault-certs.md).
2732
- **Mutual Authentication (mTLS)**: Application Gateway v2 supports authentication of client requests. For more information, see [Overview of mutual authentication with Application Gateway](mutual-authentication-overview.md).
2833
- **Azure Kubernetes Service Ingress Controller**: The Application Gateway v2 Ingress Controller allows the Azure Application Gateway to be used as the ingress for an Azure Kubernetes Service (AKS) known as AKS Cluster. For more information, see [What is Application Gateway Ingress Controller](ingress-controller-overview.md).
29-
- **Private link**: The v2 SKU offers private connectivity from other virtual networks in other regions and subscriptions through the use of private endpoints.
34+
- **Private link**: The v2 SKU offers private connectivity from other virtual networks in other regions and subscriptions by using private endpoints.
3035
- **Performance enhancements**: The v2 SKU offers up to 5X better TLS offload performance as compared to the Standard/WAF SKU.
31-
- **Faster deployment and update time**: The v2 SKU provides faster deployment and update time as compared to Standard/WAF SKU. This also includes WAF configuration changes.
36+
- **Faster deployment and update time**: The v2 SKU provides faster deployment and update time as compared to Standard/WAF SKU. The faster time also includes WAF configuration changes.
3237

3338
![Diagram of auto-scaling zone.](./media/application-gateway-autoscaling-zone-redundant/application-gateway-autoscaling-zone-redundant.png)
3439

40+
> [!NOTE]
41+
> Some of the capabilities listed here are dependent on the SKU type.
42+
43+
## SKU types
44+
45+
Application Gateway v2 is available under two SKUs:
46+
- **Basic** (preview): The Basic SKU is designed for applications that have lower traffic and SLA requirements, and don't need advanced traffic management features. For information on how to register for the public preview of Application Gateway Basic SKU, see [Register for the preview](#register-for-the-preview).
47+
- **Standard_v2 SKU**: The Standard_v2 SKU is designed for running production workloads and high traffic. It also includes auto scale that can automatically adjust the number of instances to match your traffic needs.
48+
49+
The following table displays a comparison between Basic and Standard_v2.
50+
51+
| Feature | Capabilities | Basic SKU (preview)| Standard SKU |
52+
| :---: | :--- | :---: | :---: |
53+
| Reliability | SLA | 99.9 | 99.95 |
54+
| Functionality - basic | HTTP/HTTP2/HTTPS<br>Websocket<br>Public/Private IP<br>Cookie Affinity<br>Path-based affinity<br>Wildcard<br>Multisite<br>KeyVault<br>AKS (via AGIC)<br>Zone | &#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br> | &#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;|
55+
| Functionality - advanced | URL rewrite<br>mTLS<br>Private Link<br>Private-only<sup>1</sup><br>TCP/TLS Proxy | | &#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713;<br>&#x2713; |
56+
| Scale | Max. connections per second<br>Number of listeners<br>Number of backend pools<br>Number of backend servers per pool<br>Number of rules | 200<sup>1</sup><br>5<br>5<br>5<br>5 | 62500<sup>1</sup><br>100<br>100<br>1200<br>400 |
57+
| Capacity Unit | Connections per second per compute unit<br>Throughput<br>Persistent new connections | 10<br>2.22 Mbps<br>2500 | 50<br>2.22 Mbps<br>2500 |
58+
59+
<sup>1</sup>Estimated based on using an RSA 2048-bit key TLS certificate.
60+
61+
## Pricing
62+
63+
With the v2 SKU, consumption drives the pricing model and is no longer attached to instance counts or sizes. To learn more, see [Understanding pricing](understanding-pricing.md).
64+
3565
## Unsupported regions
3666

37-
The Standard_v2 and WAF_v2 SKU isn't currently available in the following regions:
67+
Currently, the Standard_v2 and WAF_v2 SKUs aren't available in the following regions:
3868

3969
- UK North
4070
- UK South 2
@@ -43,18 +73,11 @@ The Standard_v2 and WAF_v2 SKU isn't currently available in the following region
4373
- US DOD East
4474
- US DOD Central
4575

46-
## Pricing
47-
48-
With the v2 SKU, the pricing model is based on consumption. It's no longer attached to instance counts or sizes. The v2 SKU pricing has two components:
49-
50-
- **Fixed price** - This is an hourly (or partial hour) price to provision a Standard_v2 or WAF_v2 Gateway. It's important to understand that zero additional minimum instances still ensures high availability of the service, and is always included with fixed price.
51-
- **Capacity Unit price** - This is a consumption-based cost that is charged in addition to the fixed cost. Capacity unit charge is also computed hourly or partial hourly. There are three dimensions to capacity unit - compute unit, persistent connections, and throughput. Compute unit is a measure of processor capacity consumed. Factors affecting compute unit are TLS connections/sec, URL Rewrite computations, and WAF rule processing. Persistent connection is a measure of established TCP connections to the application gateway in a given billing interval. Throughput is average Megabits/sec processed by the system in a given billing interval. The billing is done at a Capacity Unit level for anything above the reserved instance count.
52-
53-
Each capacity unit is composed of at most: 1 compute unit, 2500 persistent connections, and 2.22-Mbps throughput.
76+
## Migrate from v1 to v2
5477

55-
To learn more, see [Understanding pricing](understanding-pricing.md).
78+
An Azure PowerShell script is available in the PowerShell gallery to help you migrate from your v1 Application Gateway/WAF to the v2 Autoscaling SKU. This script helps you copy the configuration from your v1 gateway. Traffic migration is still your responsibility. For more information, see [Migrate Azure Application Gateway from v1 to v2](migrate-v1-v2.md).
5679

57-
## Feature comparison between v1 SKU and v2 SKU
80+
### Feature comparison between v1 SKU and v2 SKU
5881

5982
The following table compares the features available with each SKU.
6083

@@ -66,7 +89,7 @@ The following table compares the features available with each SKU.
6689
| Azure Kubernetes Service (AKS) Ingress controller | | &#x2713; |
6790
| Azure Key Vault integration | | &#x2713; |
6891
| Rewrite HTTP(S) headers | | &#x2713; |
69-
| Enhanced Network Control (NSG, Route Table, Private IP Frontend only) | | &#x2713; |
92+
| Enhanced Network Control (NSG, Route Table, Private IP Frontend only) | | &#x2713; |
7093
| URL-based routing | &#x2713; | &#x2713; |
7194
| Multiple-site hosting | &#x2713; | &#x2713; |
7295
| Mutual Authentication (mTLS) | | &#x2713; |
@@ -75,7 +98,7 @@ The following table compares the features available with each SKU.
7598
| Web Application Firewall (WAF) | &#x2713; | &#x2713; |
7699
| WAF custom rules | | &#x2713; |
77100
| WAF policy associations | | &#x2713; |
78-
| Transport Layer Security (TLS)/Secure Sockets Layer (SSL) termination | &#x2713; | &#x2713; |
101+
| Transport Layer Security (TLS)/Secure Sockets Layer (SSL) termination | &#x2713; | &#x2713; |
79102
| End-to-end TLS encryption | &#x2713; | &#x2713; |
80103
| Session affinity | &#x2713; | &#x2713; |
81104
| Custom error pages | &#x2713; | &#x2713; |
@@ -88,7 +111,7 @@ The following table compares the features available with each SKU.
88111
> [!NOTE]
89112
> The autoscaling v2 SKU now supports [default health probes](application-gateway-probe-overview.md#default-health-probe) to automatically monitor the health of all resources in its backend pool and highlight those backend members that are considered unhealthy. The default health probe is automatically configured for backends that don't have any custom probe configuration. To learn more, see [health probes in application gateway](application-gateway-probe-overview.md).
90113
91-
## Differences from v1 SKU
114+
### Differences from the v1 SKU
92115

93116
This section describes features and limitations of the v2 SKU that differ from the v1 SKU.
94117

@@ -105,13 +128,34 @@ This section describes features and limitations of the v2 SKU that differ from t
105128
|Cookie Affinity |Current V2 doesn't support appending the domain in session affinity Set-Cookie, which means that the cookie can't be used by client for the subdomains.|
106129
|Microsoft Defender for Cloud integration|Not yet available.
107130

108-
## Migrate from v1 to v2
131+
## Register for the preview
109132

110-
An Azure PowerShell script is available in the PowerShell gallery to help you migrate from your v1 Application Gateway/WAF to the v2 Autoscaling SKU. This script helps you copy the configuration from your v1 gateway. Traffic migration is still your responsibility. For more information, see [Migrate Azure Application Gateway from v1 to v2](migrate-v1-v2.md).
133+
Run the following Azure CLI commands to register for the preview of Application Gateway Basic SKU.
134+
135+
```azurecli-interactive
136+
Set-AzContext -Subscription "<your subscription ID>"
137+
Get-AzProviderFeature -FeatureName AllowApplicationGatewayBasicSku -ProviderNamespace "Microsoft.Network"
138+
Register-AzProviderFeature -FeatureName AllowApplicationGatewayBasicSku -ProviderNamespace Microsoft.Network
139+
```
140+
141+
## Unregister the preview
142+
143+
To unregister from the public preview of Basic SKU:
144+
145+
1. Delete all instances of Application Gateway Basic SKU from your subscription.
146+
2. Run the following Azure CLI commands:
147+
148+
```azurecli-interactive
149+
Set-AzContext -Subscription "<your subscription ID>"
150+
Get-AzProviderFeature -FeatureName AllowApplicationGatewayBasicSku -ProviderNamespace "Microsoft.Network"
151+
Unregister-AzProviderFeature -FeatureName AllowApplicationGatewayBasicSku -ProviderNamespace Microsoft.Network
152+
```
111153

112154
## Next steps
113155

114156
Depending on your requirements and environment, you can create a test Application Gateway using either the Azure portal, Azure PowerShell, or Azure CLI.
115157

158+
159+
116160
- [Tutorial: Create an application gateway that improves web application access](tutorial-autoscale-ps.md)
117161
- [Learn module: Introduction to Azure Application Gateway](/training/modules/intro-to-azure-application-gateway)

articles/application-gateway/quick-create-bicep.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ description: In this quickstart, you learn how to use Bicep to create an Azure A
55
services: application-gateway
66
author: greg-lindsay
77
ms.author: greglin
8-
ms.date: 02/28/2024
8+
ms.date: 04/18/2024
99
ms.topic: quickstart
1010
ms.service: application-gateway
1111
ms.custom: mvc, subject-armqs, mode-arm, devx-track-bicep
1212
---
1313

1414
# Quickstart: Direct web traffic with Azure Application Gateway - Bicep
1515

16-
In this quickstart, you use Bicep to create an Azure Application Gateway. Then you test the application gateway to make sure it works correctly.
16+
In this quickstart, you use Bicep to create an Azure Application Gateway. Then you test the application gateway to make sure it works correctly. The Standard v2 SKU is used in this example.
1717

1818
[!INCLUDE [About Bicep](../../includes/resource-manager-quickstart-bicep-introduction.md)]
1919

@@ -31,6 +31,9 @@ The Bicep file used in this quickstart is from [Azure Quickstart Templates](http
3131

3232
:::code language="bicep" source="~/quickstart-templates/demos/ag-docs-qs/main.bicep":::
3333

34+
> [!TIP]
35+
> You can modify values of the `Name` and `Tier` parameters under `resource\applicationGateWay\properties\sku` to use a different SKU. For example: `Basic`.
36+
3437
Multiple Azure resources are defined in the Bicep file:
3538

3639
- [**Microsoft.Network/applicationgateways**](/azure/templates/microsoft.network/applicationgateways)

articles/application-gateway/quick-create-cli.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: application-gateway
66
author: greg-lindsay
77
ms.service: application-gateway
88
ms.topic: quickstart
9-
ms.date: 11/06/2023
9+
ms.date: 01/23/2024
1010
ms.author: greglin
1111
ms.custom: mvc, devx-track-azurecli, mode-api
1212
---
@@ -143,7 +143,9 @@ done
143143

144144
## Create the application gateway
145145

146-
Create an application gateway using `az network application-gateway create`. When you create an application gateway with the Azure CLI, you specify configuration information, such as capacity, SKU, and HTTP settings. Azure then adds the private IP addresses of the network interfaces as servers in the backend pool of the application gateway.
146+
Create an application gateway using `az network application-gateway create`. When you create an application gateway with the Azure CLI, you specify configuration information, such as capacity, SKU (for example: `Basic`), and HTTP settings. Azure then adds the private IP addresses of the network interfaces as servers in the backend pool of the application gateway.
147+
148+
The Standard v2 SKU is used in this example.
147149

148150
```azurecli-interactive
149151
address1=$(az network nic show --name myNic1 --resource-group myResourceGroupAG | grep "\"privateIPAddress\":" | grep -oE '[^ ]+$' | tr -d '",')

0 commit comments

Comments
 (0)