Skip to content

Latest commit

 

History

History
84 lines (60 loc) · 2.55 KB

Azure.AppGw.MigrateV2.md

File metadata and controls

84 lines (60 loc) · 2.55 KB
Raw
severity pillar category resource online version
Important
Operational Excellence
Infrastructure provisioning
Application Gateway

Migrate to Application Gateway v2

SYNOPSIS

Use a Application Gateway v2 SKU.

DESCRIPTION

The Application Gateway v1 SKUs (Standard and WAF) will be retired on April 28, 2026. To avoid service disruption, migrate to Application Gateway v2 SKUs.

The v2 SKUs offers performance enhancements, security controls and adds support for critical new features like autoscaling, zone redundancy, support for static VIPs, header rewrite, key vault integration, mutual authentication (mTLS), Azure Kubernetes Service ingress controller and private link.

RECOMMENDATION

Migrate deprecated v1 Application Gateways to a v2 SKU before retirement to avoid service disruption.

EXAMPLES

Configure with Azure template

To deploy Application Gateways that pass this rule:

  • Set properties.sku.tier or properties.sku.name to Standard_v2 (Application Gateway) or WAF_v2 (Web Application Firewall).

For example:

{
  "name": "[parameters('name')]",
  "type": "Microsoft.Network/applicationGateways",
  "apiVersion": "2022-07-01",
  "location": "[resourceGroup().location]",
  "properties": {
    "sku": {
      "capacity": 2,
      "name": "WAF_v2",
      "tier": "WAF_v2"
    }
  }
}

Configure with Bicep

To deploy Application Gateways that pass this rule:

  • Set properties.sku.tier or properties.sku.name to Standard_v2 (Application Gateway) or WAF_v2 (Web Application Firewall).

For example:

resource appGw 'Microsoft.Network/applicationGateways@2022-07-01' = {
  name: 
  location: location
  properties: {
    sku: {
      capacity: 2
      name: 'WAF_v2'
      tier: 'WAF_v2'
    }
  }
}

NOTES

This rule is applicable for both Application Gateways and Application Gateways with Web Application Firewall (WAF).

Not all existing features under the v1 SKUs are supported in the v2 SKUs. The v2 SKUs are not currently available in all regions.

LINKS