Skip to content

Commit 4262ca0

Browse files
committed
mcr updates
1 parent 35d041d commit 4262ca0

7 files changed

+41
-37
lines changed

articles/application-gateway/ingress-controller-add-health-probes.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,17 @@ services: application-gateway
55
author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.topic: how-to
8-
ms.date: 06/10/2022
8+
ms.date: 9/17/2024
99
ms.author: greglin
1010
---
1111

1212
# Add Health Probes to your service
1313
By default, Ingress controller will provision an HTTP GET probe for the exposed pods.
1414
The probe properties can be customized by adding a [Readiness or Liveness Probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/) to your `deployment`/`pod` spec.
1515

16+
> [!TIP]
17+
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
18+
1619
## With `readinessProbe` or `livenessProbe`
1720
```yaml
1821
apiVersion: networking.k8s.io/v1

articles/application-gateway/ingress-controller-annotations.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,17 @@ services: application-gateway
55
author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.topic: conceptual
8-
ms.date: 5/13/2024
8+
ms.date: 9/17/2024
99
ms.author: greglin
1010
---
1111

1212
# Annotations for Application Gateway Ingress Controller
1313

1414
You can annotate the Kubernetes ingress resource with arbitrary key/value pairs. Application Gateway Ingress Controller (AGIC) relies on annotations to program Azure Application Gateway features that aren't configurable via the ingress YAML. Ingress annotations are applied to all HTTP settings, backend pools, and listeners derived from an ingress resource.
1515

16+
> [!TIP]
17+
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
18+
1619
## List of supported annotations
1720

1821
For AGIC to observe an ingress resource, the resource *must be annotated* with `kubernetes.io/ingress.class: azure/application-gateway`.

articles/application-gateway/ingress-controller-autoscale-pods.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.custom:
88
ms.topic: how-to
9-
ms.date: 10/26/2023
9+
ms.date: 9/17/2024
1010
ms.author: greglin
1111
---
1212

@@ -25,6 +25,9 @@ Use following two components:
2525
> The Azure Kubernetes Metrics Adapter is no longer maintained. Kubernetes Event-driven Autoscaling (KEDA) is an alternative.<br>
2626
> Also see [Application Gateway for Containers](for-containers/overview.md).
2727
28+
> [!TIP]
29+
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
30+
2831
## Setting up Azure Kubernetes Metric Adapter
2932

3033
1. First, create a Microsoft Entra service principal and assign it `Monitoring Reader` access over Application Gateway's resource group.

articles/application-gateway/ingress-controller-cookie-affinity.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,16 @@ services: application-gateway
55
author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.topic: how-to
8-
ms.date: 11/4/2019
8+
ms.date: 9/17/2024
99
ms.author: greglin
1010
---
1111

1212
# Enable Cookie based affinity with an Application Gateway
1313
As outlined in the [Azure Application Gateway Documentation](./application-gateway-components.md#http-settings), Application Gateway supports cookie based affinity, which means it can direct subsequent traffic from a user session to the same server for processing.
1414

15+
> [!TIP]
16+
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
17+
1518
## Example
1619
```yaml
1720
apiVersion: networking.k8s.io/v1

articles/application-gateway/ingress-controller-disable-addon.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,16 @@ services: application-gateway
55
author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.topic: how-to
8-
ms.date: 06/10/2020
8+
ms.date: 9/17/2024
99
ms.author: greglin
1010
---
1111

1212
# Disable and re-enable AGIC add-on for your AKS cluster
1313
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 will differ 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.
1414

15+
> [!TIP]
16+
> Also see [What is Application Gateway for Containers](for-containers/overview.md).
17+
1518
## Disabling AGIC add-on with associated Application Gateway
1619
If the AGIC add-on automatically deployed the Application Gateway for you when you first set everything up, 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:
1720
- Is the Application Gateway that the AGIC add-on is associated with deployed in the MC_* node resource group?

articles/application-gateway/ingress-controller-install-existing.md

Lines changed: 18 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.custom: devx-track-arm-template, devx-track-azurecli
88
ms.topic: how-to
9-
ms.date: 02/07/2024
9+
ms.date: 9/17/2024
1010
ms.author: greglin
1111
---
1212

@@ -51,23 +51,17 @@ Gateway should that become necessary
5151
[Helm](/azure/aks/kubernetes-helm) is a package manager for Kubernetes, used to install the `application-gateway-kubernetes-ingress` package.
5252

5353
> [!NOTE]
54-
> If you use [Cloud Shell](https://shell.azure.com/), you don't need to install Helm. Azure Cloud Shell comes with Helm version 3. Skip the first step and just add the AGIC Helm repository.
54+
> If you use [Cloud Shell](https://shell.azure.com/), you don't need to install Helm. Azure Cloud Shell comes with Helm version 3.
5555
56-
1. Install [Helm](/azure/aks/kubernetes-helm) and run the following to add `application-gateway-kubernetes-ingress` helm package:
56+
Install [Helm](/azure/aks/kubernetes-helm) and run the following:
5757

58-
- *Kubernetes RBAC enabled* AKS cluster
58+
- *Kubernetes RBAC enabled* AKS cluster
5959

60-
```bash
61-
kubectl create serviceaccount --namespace kube-system tiller-sa
62-
kubectl create clusterrolebinding tiller-cluster-rule --clusterrole=cluster-admin --serviceaccount=kube-system:tiller-sa
63-
helm init --tiller-namespace kube-system --service-account tiller-sa
64-
```
65-
66-
2. Add the AGIC Helm repository:
67-
```bash
68-
helm repo add application-gateway-kubernetes-ingress https://appgwingress.blob.core.windows.net/ingress-azure-helm-package/
69-
helm repo update
70-
```
60+
```bash
61+
kubectl create serviceaccount --namespace kube-system tiller-sa
62+
kubectl create clusterrolebinding tiller-cluster-rule --clusterrole=cluster-admin --serviceaccount=kube-system:tiller-sa
63+
helm init --tiller-namespace kube-system --service-account tiller-sa
64+
```
7165

7266
## Azure Resource Manager Authentication
7367

@@ -206,12 +200,11 @@ kubectl apply -f $file -n $namespace
206200

207201
## Install Ingress Controller as a Helm Chart
208202

209-
In the first few steps, we install Helm's Tiller on your Kubernetes cluster. Use [Cloud Shell](https://shell.azure.com/) to install the AGIC Helm package:
203+
In the first few steps, we installed Helm's Tiller on your Kubernetes cluster. Use [Cloud Shell](https://shell.azure.com/) to install the AGIC Helm package:
210204

211-
1. Add the `application-gateway-kubernetes-ingress` helm repo and perform a helm update
205+
1. Perform a helm update
212206

213207
```bash
214-
helm repo add application-gateway-kubernetes-ingress https://appgwingress.blob.core.windows.net/ingress-azure-helm-package/
215208
helm repo update
216209
```
217210

@@ -280,17 +273,18 @@ In the first few steps, we install Helm's Tiller on your Kubernetes cluster. Use
280273
> [!NOTE]
281274
> The `<identity-client-id>` is a property of the Microsoft Entra Workload ID you setup in the previous section. You can retrieve this information by running the following command: `az identity show -g <resourcegroup> -n <identity-name>`, where `<resourcegroup>` is the resource group hosting the infrastructure resources related to the AKS cluster, Application Gateway and managed identity.
282275

283-
1. Install Helm chart `application-gateway-kubernetes-ingress` with the `helm-config.yaml` configuration from the previous step
276+
1. Install Helm chart with the `helm-config.yaml` configuration from the previous step
284277

285278
```bash
286-
helm install -f <helm-config.yaml> application-gateway-kubernetes-ingress/ingress-azure
279+
helm install agic-controller oci://mcr.microsoft.com/azure-application-gateway/charts/ingress-azure --version 1.7.5 -f helm-config.yaml
287280
```
288281

289282
Alternatively you can combine the `helm-config.yaml` and the Helm command in one step:
290283

291284
```bash
292-
helm install ./helm/ingress-azure \
293-
--name ingress-azure \
285+
helm install oci://mcr.microsoft.com/azure-application-gateway/charts/ingress-azure \
286+
--name agic-controller \
287+
--version 1.7.5 \
294288
--namespace default \
295289
--debug \
296290
--set appgw.name=applicationgatewayABCD \
@@ -379,7 +373,8 @@ Apply the Helm changes:
379373
helm upgrade \
380374
--recreate-pods \
381375
-f helm-config.yaml \
382-
ingress-azure application-gateway-kubernetes-ingress/ingress-azure
376+
agic-controller
377+
oci://mcr.microsoft.com/azure-application-gateway/charts/ingress-azure
383378
```
384379
385380
As a result, your AKS cluster has a new instance of `AzureIngressProhibitedTarget` called `prohibit-all-targets`:

articles/application-gateway/ingress-controller-install-new.md

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: greg-lindsay
66
ms.service: azure-application-gateway
77
ms.custom:
88
ms.topic: how-to
9-
ms.date: 07/28/2023
9+
ms.date: 9/17/2024
1010
ms.author: greglin
1111
---
1212

@@ -155,7 +155,7 @@ To install Microsoft Entra Pod Identity to your cluster:
155155
> [!NOTE]
156156
> If you use [Cloud Shell](https://shell.azure.com/), you don't need to install Helm. Azure Cloud Shell comes with Helm version 3. Skip the first step and just add the AGIC Helm repository.
157157

158-
1. Install [Helm](/azure/aks/kubernetes-helm) and run the following to add `application-gateway-kubernetes-ingress` helm package:
158+
1. Install [Helm](/azure/aks/kubernetes-helm) and run the following:
159159

160160
- *Kubernetes RBAC enabled* AKS cluster
161161

@@ -171,12 +171,6 @@ To install Microsoft Entra Pod Identity to your cluster:
171171
helm init
172172
```
173173

174-
2. Add the AGIC Helm repository:
175-
```bash
176-
helm repo add application-gateway-kubernetes-ingress https://appgwingress.blob.core.windows.net/ingress-azure-helm-package/
177-
helm repo update
178-
```
179-
180174
### Install Ingress Controller Helm Chart
181175

182176
1. Use the `deployment-outputs.json` file created above and create the following variables.
@@ -285,7 +279,7 @@ To install Microsoft Entra Pod Identity to your cluster:
285279
1. Install the Application Gateway ingress controller package:
286280

287281
```bash
288-
helm install -f helm-config.yaml --generate-name application-gateway-kubernetes-ingress/ingress-azure
282+
helm install agic-controller oci://mcr.microsoft.com/azure-application-gateway/charts/ingress-azure --version 1.7.5 -f helm-config.yaml
289283
```
290284

291285
## Install a Sample App

0 commit comments

Comments
 (0)