Skip to content

Commit a8ee789

Browse files
committed
edit pass: articles-about-ingress-for-aks
1 parent b5993c4 commit a8ee789

File tree

3 files changed

+240
-252
lines changed

3 files changed

+240
-252
lines changed
Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Disable and re-enable Application Gateway Ingress Controller add-on for Azure Kubernetes Service cluster
3-
description: This article provides information on how to disable and re-enable the AGIC add-on for your AKS cluster
3+
description: This article provides information on how to disable and re-enable the AGIC add-on for your AKS cluster.
44
services: application-gateway
55
author: greg-lindsay
66
ms.service: azure-application-gateway
@@ -9,34 +9,42 @@ ms.date: 9/17/2024
99
ms.author: greglin
1010
---
1111

12-
# Disable and re-enable AGIC add-on for your AKS cluster
13-
Application Gateway Ingress Controller (AGIC) deployed as an AKS add-on allows you to enable and disable the add-on with one line in Azure CLI. The life cycle of the Application Gateway differs when you disable the AGIC add-on, depending on if the Application Gateway was created by the AGIC add-on, or if it was deployed separately from the AGIC add-on. You can run the same command to re-enable the AGIC add-on if you ever disable it, or to enable the AGIC add-on using an existing AKS cluster and Application Gateway.
12+
# Disable and re-enable the AGIC add-on for your AKS cluster
1413

15-
> [!TIP]
16-
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
14+
The Application Gateway Ingress Controller (AGIC) deployed as an Azure Kubernetes Service (AKS) add-on allows you to enable and disable the add-on with one line in the Azure CLI.
15+
16+
The life cycle of the Azure Application Gateway instance differs when you disable the AGIC add-on, depending on if the Application Gateway was created by the AGIC add-on, or if it was deployed separately from the AGIC add-on. You can run the same command to re-enable the AGIC add-on if you ever disable it, or to enable the AGIC add-on using an existing AKS cluster and Application Gateway.
17+
18+
## Disabling AGIC add-on with associated Application Gateway
1719

18-
## Disabling AGIC add-on with associated Application Gateway
1920
If the AGIC add-on automatically deployed the Application Gateway for you when you first set up everything, then disabling the AGIC add-on will by default delete the Application Gateway based on a couple criteria. There are two criteria that the AGIC add-on looks for to determine if it should delete the associated Application Gateway when you disable it:
20-
- Is the Application Gateway that the AGIC add-on is associated with deployed in the MC_* node resource group?
21-
- Does the Application Gateway that the AGIC add-on is associated with have the tag "created-by: ingress-appgw"? The tag is used by AGIC to determine if the Application Gateway was deployed by the add-on or not.
2221

23-
If both criteria are met, then the AGIC add-on will delete the Application Gateway it created when the add-on is disabled; however, it won't delete the public IP or the subnet in which the Application Gateway was deployed with/in. If the first criteria isn't met, then it won't matter if the Application Gateway has the "created-by: ingress-appgw" tag - disabling the add-on won't delete the Application Gateway. Likewise, if the second criteria isn't met, that is. The Application Gateway lacks that tag, then disabling the add-on won't delete the Application Gateway in the MC_* node resource group.
22+
- Is the Application Gateway that the AGIC add-on is associated with deployed in the MC_* node resource group?
23+
- Does the Application Gateway that the AGIC add-on is associated with have the tag "created-by: ingress-appgw"? The tag is used by AGIC to determine if the Application Gateway was deployed by the add-on or not.
2424

25-
> [!TIP]
26-
> If you don't want the Application Gateway to be deleted when disabling the add-on, but it meets both criteria then remove the "created-by: ingress-appgw" tag to prevent the add-on from deleting your Application Gateway.
25+
If both criteria are met, then the AGIC add-on will delete the Application Gateway it created when the add-on is disabled; however, it won't delete the public IP or the subnet in which the Application Gateway was deployed with/in.
26+
27+
If the first criteria isn't met, then it won't matter if the Application Gateway has the "created-by: ingress-appgw" tag - disabling the add-on won't delete the Application Gateway. Likewise, if the second criteria isn't met, that is. The Application Gateway lacks that tag, then disabling the add-on won't delete the Application Gateway in the MC_* node resource group.
28+
29+
> [!TIP]
30+
> If you don't want the Application Gateway to be deleted when disabling the add-on, but it meets both criteria then remove the "created-by: ingress-appgw" tag to prevent the add-on from deleting your Application Gateway.
31+
32+
To disable the AGIC add-on, run the following command:
2733

28-
To disable the AGIC add-on, run the following command:
2934
```azurecli-interactive
3035
az aks disable-addons -n <AKS-cluster-name> -g <AKS-resource-group-name> -a ingress-appgw
3136
```
3237

3338
## Enable AGIC add-on on existing Application Gateway and AKS Cluster
39+
3440
If you ever disable the AGIC add-on and need to re-enable the add-on, or want to enable the add-on using an existing Application Gateway and AKS cluster, then run the following command:
3541

3642
```azurecli-interactive
3743
appgwId=$(az network application-gateway show -n <application-gateway-name> -g <resource-group-name> -o tsv --query "id")
3844
az aks enable-addons -n <AKS-cluster-name> -g <AKS-cluster-resource-group> -a ingress-appgw --appgw-id $appgwId
3945
```
4046

41-
## Next steps
42-
For more information on how to enable the AGIC add-on using an existing Application Gateway and AKS cluster, see [AGIC add-on brownfield deployment](tutorial-ingress-controller-add-on-existing.md).
47+
## Related content
48+
49+
- For more information on how to enable the AGIC add-on using an existing Application Gateway and AKS cluster, see [AGIC add-on brownfield deployment](tutorial-ingress-controller-add-on-existing.md).
50+
- For information about Application Gateway for Containers, see [What is Application Gateway for Containers?](for-containers/overview.md).

0 commit comments

Comments
 (0)