Ingress configureren met de Kubernetes Gateway API via de add-on voor app-routering voor Azure Kubernetes Service (AKS)

Azure CLI-versie bijwerken

U moet versie azure-cli of hoger gebruiken2.86.0. Voer az --version uit om uw azure-cli-versie te vinden en voer az upgrade uit om te upgraden.

Beheerde Gateway API-CRD’s inschakelen

Schakel de installatie van de Managed Gateway-API in. Het gebruik van zelfbeheerde GATEWAY-API-CRD's met de invoegtoepassing voor toepassingsroutering wordt niet ondersteund.

AKS Automatisch standaardgedrag (AKS 1.36 en hoger)

Op nieuwe automatische AKS-clusters met AKS 1.36 of hoger is de Kubernetes Gateway-API standaard ingeschakeld via de invoegtoepassing voor toepassingsroutering.

Normaal gesproken hoeft u de opdracht voor het inschakelen van functies niet uit te voeren, tenzij u:

• Een bestaand cluster gebruiken.
• Een eerdere versie van AKS gebruiken.
• Schakel de functie opnieuw in nadat deze is uitgeschakeld.

De implementatie van de gateway-API voor toepassingsroutering inschakelen

Inschakelen tijdens het maken van het cluster

Voer de volgende opdracht uit om de gateway-API-implementatie voor toepassingsroutering in te schakelen tijdens het maken van een AKS Standard-cluster:

# Set environment variables
export CLUSTER=<cluster-name>
export RESOURCE_GROUP=<resource-group-name>

# Enable the application routing Gateway API implementation during AKS Standard cluster creation
az aks create --resource-group ${RESOURCE_GROUP} --name ${CLUSTER} --enable-gateway-api --enable-app-routing-istio

Inschakelen voor een bestaand cluster

Voer de volgende opdracht uit om de implementatie van de gateway-API voor toepassingsroutering in te schakelen voor een bestaand cluster:

# Set environment variables
export CLUSTER=<cluster-name>
export RESOURCE_GROUP=<resource-group-name>

# Enable the application routing Gateway API implementation for an existing cluster
az aks update --resource-group ${RESOURCE_GROUP} --name ${CLUSTER} --enable-gateway-api --enable-app-routing-istio

Je zou istiod pods in de aks-istio-system namespace moeten zien.

kubectl get pods -n aks-istio-system

NAME                      READY   STATUS    RESTARTS   AGE
istiod-12a3bc45de-fghi6   1/1     Running   0          3m15s
istiod-78j9kl01mn-opqrs   1/1     Running   0          3m

U ziet ook dat de ValidatingWebhookConfiguration implementatie wordt uitgevoerd:

kubectl get validatingwebhookconfiguration

NAME                                        WEBHOOKS   AGE
aks-node-validating-webhook                 1          117m
azure-service-mesh-ccp-validating-webhook   1          4m2s

Als u de installatie van de Managed Gateway-API hebt ingeschakeld, ziet u ook dat de ConfigMap-aanpassing van de Istio-gateway wordt gemaakt:

kubectl get cm -n aks-istio-system

NAME                                  DATA   AGE
...
istio-gateway-class-defaults          2      43s
...

Inkomend verkeer configureren met behulp van een Kubernetes-gateway

Voorbeeldtoepassing implementeren

Implementeer eerst de voorbeeldtoepassing httpbin in de default naamruimte:

export ISTIO_RELEASE="release-1.27"
kubectl apply -f https://raw.githubusercontent.com/istio/istio/$ISTIO_RELEASE/samples/httpbin/httpbin.yaml

Kubernetes Gateway en HTTPRoute maken

Implementeer vervolgens een API-gatewayconfiguratie in de default naamruimte met de gatewayClassName ingesteld op approuting-istio.

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: httpbin-gateway
spec:
  gatewayClassName: approuting-istio
  listeners:
  - name: http
    port: 80
    protocol: HTTP
    allowedRoutes:
      namespaces:
        from: Same
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: httpbin
spec:
  parentRefs:
  - name: httpbin-gateway
  hostnames: ["httpbin.example.com"]
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /get
    backendRefs:
    - name: httpbin
      port: 8000
EOF

Controleer of een Deployment, Service, HorizontalPodAutoscaler en PodDisruptionBudget worden aangemaakt voor httpbin-gateway:

kubectl get deployment httpbin-gateway-approuting-istio

NAME                               READY   UP-TO-DATE   AVAILABLE   AGE
httpbin-gateway-approuting-istio   2/2     2            2           6m41s

kubectl get service httpbin-gateway-approuting-istio

NAME                               TYPE           CLUSTER-IP   EXTERNAL-IP      PORT(S)                        AGE
httpbin-gateway-approuting-istio   LoadBalancer   10.0.54.96   <external-ip>    15021:30580/TCP,80:32693/TCP   7m13s

kubectl get hpa httpbin-gateway-approuting-istio

NAME                               REFERENCE                                     TARGETS       MINPODS   MAXPODS   REPLICAS   AGE
httpbin-gateway-approuting-istio   Deployment/httpbin-gateway-approuting-istio   cpu: 3%/80%   2         5         2          8m13s

kubectl get pdb httpbin-gateway-approuting-istio

NAME                               MIN AVAILABLE   MAX UNAVAILABLE   ALLOWED DISRUPTIONS   AGE
httpbin-gateway-approuting-istio   1               N/A               1                     9m1s

Aanvraag verzenden naar voorbeeldtoepassing

Probeer ten slotte een curl aanvraag naar de httpbin toepassing te verzenden. Stel eerst de INGRESS_HOST omgevingsvariabele in:

kubectl wait --for=condition=programmed gateways.gateway.networking.k8s.io httpbin-gateway
export INGRESS_HOST=$(kubectl get gateways.gateway.networking.k8s.io httpbin-gateway -ojsonpath='{.status.addresses[0].value}')

Verzend vervolgens een HTTP-aanvraag naar httpbin:

curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST/get"

U zou een HTTP 200 antwoord moeten zien.

Als u Terraform wilt gebruiken om een AKS-cluster te maken waarvoor de implementatie van de gateway-API voor toepassingsroutering is ingeschakeld, hebt u het volgende nodig:

• Terraform-versie1.9.0 of hoger geïnstalleerd.
• Azure CLI is geïnstalleerd en geverifieerd. Voer az --version uit om uw azure-cli-versie te vinden en voer az upgrade uit om te upgraden. U gebruikt de Azure CLI om verbinding te maken met het cluster nadat Terraform het heeft gemaakt.
• kubectl geïnstalleerd. U kunt deze lokaal installeren met behulp van de az aks install-cli opdracht. U gebruikt kubectl om de voorbeeldtoepassing en gateway-API-resources te implementeren.

Een AKS-cluster implementeren met de implementatie van de gateway-API voor toepassingsroutering met behulp van Terraform

In deze sectie wordt beschreven hoe u Terraform gebruikt om een AKS-cluster te implementeren met de installatie van de Managed Gateway-API en de implementatie van de gateway-API voor toepassingsroutering ingeschakeld.

In dit voorbeeld wordt het volgende geïmplementeerd:

• Een resourcegroep.
• Een AKS-cluster dat gebruikmaakt van de Azure CNI-netwerkinvoegtoepassing en een standaard load balancer.
• De api-installatie van Managed Gateway en de implementatie van de gateway-API voor toepassingsroutering, beide ingeschakeld op het cluster via de AzAPI-provider. Als u beide instellingen inschakelt, wordt de door AKS beheerde approuting-istio GatewayClass beschikbaar op het cluster.

1. Maak een map om de Terraform-voorbeeldcode te testen en uit te voeren, en stel deze in als de huidige werkmap.

2. Maak een bestand met de naam main.tfen voeg de volgende code in:

   terraform {
     required_version = ">= 1.9.0"
   
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~> 4.0"
       }
       azapi = {
         source  = "Azure/azapi"
         version = "~> 2.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~> 3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   
   provider "azapi" {
     enable_preflight = true
   }
   
   resource "random_string" "suffix" {
     length  = 6
     upper   = false
     special = false
   }
   
   locals {
     location            = "eastus"
     resource_group_name = "rg-aks-gateway-api-${random_string.suffix.result}"
     cluster_name        = "aks-gwapi-${random_string.suffix.result}"
   }
   
   resource "azurerm_resource_group" "example" {
     name     = local.resource_group_name
     location = local.location
   }
   
   resource "azurerm_kubernetes_cluster" "example" {
     name                              = local.cluster_name
     location                          = azurerm_resource_group.example.location
     resource_group_name               = azurerm_resource_group.example.name
     dns_prefix                        = local.cluster_name
     role_based_access_control_enabled = true
   
     default_node_pool {
       name       = "system"
       node_count = 2
       vm_size    = "Standard_D4s_v4"
   
       upgrade_settings {
         drain_timeout_in_minutes      = 0
         max_surge                     = "10%"
         node_soak_duration_in_minutes = 0
       }
     }
   
     identity {
       type = "SystemAssigned"
     }
   
     network_profile {
       network_plugin    = "azure"
       load_balancer_sku = "standard"
     }
   }
   
   resource "azapi_update_resource" "gateway_api_app_routing" {
     type        = "Microsoft.ContainerService/managedClusters@2026-03-01"
     resource_id = azurerm_kubernetes_cluster.example.id
     body = {
       properties = {
         ingressProfile = {
           gatewayAPI = {
             installation = "Standard"
           }
           webAppRouting = {
             gatewayAPIImplementations = {
               appRoutingIstio = {
                 mode = "Enabled"
               }
             }
           }
         }
       }
     }
     response_export_values = [
       "properties.ingressProfile"
     ]
     depends_on = [
       azurerm_kubernetes_cluster.example
     ]
   }
   
   output "resource_group_name" {
     value = azurerm_resource_group.example.name
   }
   
   output "cluster_name" {
     value = azurerm_kubernetes_cluster.example.name
   }
   
   output "get_credentials_command" {
     value = "az aks get-credentials --resource-group ${azurerm_resource_group.example.name} --name ${azurerm_kubernetes_cluster.example.name} --overwrite-existing"
   }
   

3. Initialiseer Terraform door de opdracht uit te terraform init voeren. Met deze opdracht worden de Azure providers gedownload die zijn vereist voor het beheren van Azure resources met Terraform.

   terraform init
   

4. Maak de configuratie op en valideer deze door de terraform fmt en terraform validate opdrachten uit te voeren.

   terraform fmt
   terraform validate
   

5. Maak een Terraform-uitvoeringsplan door de opdracht uit te terraform plan voeren. Met deze opdracht ziet u de resources die Terraform maakt of wijzigt in uw Azure-abonnement.

   terraform plan
   

6. Pas het Terraform-uitvoeringsplan toe door de opdracht uit te terraform apply voeren. Met deze opdracht worden de resources gemaakt die zijn gedefinieerd in uw main.tf bestand in uw Azure-abonnement. Wanneer u hierom wordt gevraagd, voert u yes dit in om te bevestigen.

   terraform apply
   

Verbinding maken met het AKS-cluster met behulp van Terraform

1. Haal de resourcegroep- en clusternamen op uit de Terraform-uitvoer.

   terraform output -raw resource_group_name
   terraform output -raw cluster_name
   

2. Configureer kubectl zo dat deze verbinding maakt met uw cluster met de opdracht az aks get-credentials. Met deze opdracht worden inloggegevens gedownload en wordt de Kubernetes-CLI geconfigureerd om deze te gebruiken. Vervang <resource-group-name> en <cluster-name> door de waarden uit de vorige stap. U kunt ook terraform output -raw get_credentials_command uitvoeren om het volledige, gebruiksklare commando te krijgen.

   az aks get-credentials --resource-group <resource-group-name> --name <cluster-name>
   

3. Controleer of het cluster actief is door de opdracht kubectl get nodes uit te voeren.

   kubectl get nodes
   

De gateway-API-configuratie controleren met behulp van Terraform

1. Controleer of de istiod pods worden uitgevoerd in de aks-istio-system naamruimte.

   kubectl get pods -n aks-istio-system
   

2. Controleer of de approuting-istio GatewayClass bestaat en wordt geaccepteerd.

   kubectl get gatewayclass
   

   De approuting-istio GatewayClass moet True teruggeven in de kolom ACCEPTED.

Inkomend verkeer configureren met behulp van een Kubernetes-gateway met Terraform

De voorbeeldtoepassing implementeren met behulp van Terraform

Implementeer de voorbeeldtoepassing httpbin in de default naamruimte:

kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.27/samples/httpbin/httpbin.yaml

Controleer of de httpbin pod en service beschikbaar zijn:

kubectl get pods -l app=httpbin
kubectl get svc httpbin

De gateway- en HTTPRoute-resources maken met behulp van Terraform

Het implementatievoorbeeld van de gateway-API voor toepassingsroutering bevat een Gateway manifest waarmee een HTTP-listener wordt gemaakt op poort 80 en de door AKS beheerde approuting-istio GatewayClass wordt gebruikt.

1. Maak een bestand met de naam gateway.yamlen voeg de volgende code in:

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway
   metadata:
     name: httpbin-gateway
   spec:
     gatewayClassName: approuting-istio
     listeners:
       - name: http
         port: 80
         protocol: HTTP
         allowedRoutes:
           namespaces:
             from: Same
   

2. Gateway De configuratie toepassen:

   kubectl apply -f gateway.yaml
   

   Het voorbeeld bevat ook een HTTPRoute manifest dat verzoeken voor httpbin.example.com/get doorstuurt naar de httpbin-service op poort 8000.

3. Maak een bestand met de naam httproute.yamlen voeg de volgende code in:

   apiVersion: gateway.networking.k8s.io/v1
   kind: HTTPRoute
   metadata:
     name: httpbin
   spec:
     parentRefs:
       - name: httpbin-gateway
     hostnames:
       - httpbin.example.com
     rules:
       - matches:
           - path:
               type: PathPrefix
               value: /get
         backendRefs:
           - name: httpbin
             port: 8000
   

4. HTTPRoute De configuratie toepassen:

   kubectl apply -f httproute.yaml
   

Controleer of een Deployment, Service, HorizontalPodAutoscaler en PodDisruptionBudget worden aangemaakt voor httpbin-gateway:

kubectl get deployment httpbin-gateway-approuting-istio
kubectl get service httpbin-gateway-approuting-istio
kubectl get hpa httpbin-gateway-approuting-istio
kubectl get pdb httpbin-gateway-approuting-istio

Een aanvraag verzenden naar de voorbeeldtoepassing met behulp van Terraform

Wacht totdat de gateway een Programmed voorwaarde rapporteert en haal vervolgens het externe adres op:

kubectl wait --for=condition=programmed gateways.gateway.networking.k8s.io httpbin-gateway
export INGRESS_HOST=$(kubectl get gateways.gateway.networking.k8s.io httpbin-gateway -ojsonpath='{.status.addresses[0].value}')

Stuur vervolgens een verzoek naar httpbin via de Gateway:

curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST/get"

U zou een HTTP 200 antwoord moeten zien.

Als u de Azure-portal wilt gebruiken om toepassingsroutering met gateway-API-implementatie mogelijk te maken, hebt u het volgende nodig:

• Een bestaand standaardcluster van Kubernetes.

Inschakelen voor een bestaand cluster

Als u toepassingsroutering wilt inschakelen met Gateway API voor een bestaand cluster, opent u de Azure-portal, selecteert u uw cluster en gaat u naar het menu Netwerken>Ingress profile. Selecteer Manage om toepassingsroutering in te schakelen met gateway-API.

Ingress configureren met behulp van een Kubernetes-gateway

Voorbeeldtoepassing implementeren

Ga eerst naar het menu Opdracht uitvoeren en gebruik de volgende opdracht om de voorbeeldtoepassing httpbin in de default naamruimte te implementeren:

ISTIO_RELEASE=release-1.27
kubectl apply -f https://raw.githubusercontent.com/istio/istio/$ISTIO_RELEASE/samples/httpbin/httpbin.yaml

Kubernetes Gateway en HTTPRoute maken

Ga naar Services, gateways en ingresses>Pas een YAML toe. Met het volgende YAML-bestand wordt een gateway-API-configuratie geïmplementeerd in de default naamruimte met de gatewayClassName set op approuting-istio.

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: httpbin-gateway
spec:
  gatewayClassName: approuting-istio
  listeners:
  - name: http
    port: 80
    protocol: HTTP
    allowedRoutes:
      namespaces:
        from: Same
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: httpbin
spec:
  parentRefs:
  - name: httpbin-gateway
  hostnames: ["httpbin.example.com"]
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /get
    backendRefs:
    - name: httpbin
      port: 8000

Gateway- en HTTPRoute-resources weergeven en beheren

U kunt gemaakte gateway- en HTTPRoute-resources weergeven in het menu Services, gateways en ingresses en eenvoudig hun status en adres controleren.

U kunt ook meer informatie over uw gateways en HTTPRoutes bekijken door hun naam te selecteren. Voorbeeld:

De implementatie van de gateway-API voor toepassingsroutering uitschakelen

Voer de volgende opdracht uit om de implementatie van de gateway-API voor toepassingsroutering uit te schakelen:

az aks update --resource-group ${RESOURCE_GROUP} --name ${CLUSTER} --disable-app-routing-istio

De hulpbronnen opschonen

Voer de volgende opdrachten uit om de Gateway en HTTPRoute resources te verwijderen:

kubectl delete gateways.gateway.networking.k8s.io httpbin-gateway
kubectl delete httproute httpbin

Als u een ConfigMap hebt gemaakt om uw Gatewayconfiguratie aan te passen, voert u de volgende opdracht uit om de ConfigMap te verwijderen:

kubectl delete configmap gw-options

Als u een SecretProviderClass en een geheim hebt gemaakt dat moet worden gebruikt voor TLS-beëindiging, verwijdert u de volgende resources:

kubectl delete secret httpbin-credential
kubectl delete pod secrets-store-sync-httpbin
kubectl delete secretproviderclass httpbin-credential-spc

Resources opschonen met behulp van Terraform

In deze sectie hebt u een voorbeeldtoepassing met naamruimtebereik en gateway-API-resources geïmplementeerd. Als u deze Kubernetes-resources niet meer nodig hebt, verwijdert u deze voordat u de onderliggende Azure-infrastructuur verwijdert.

Verwijder de HTTPRoute, Gatewayen voorbeeldtoepassing met behulp van de kubectl delete opdracht:

kubectl delete -f httproute.yaml
kubectl delete -f gateway.yaml
kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.27/samples/httpbin/httpbin.yaml

Verwijder de Azure resources die door Terraform zijn gemaakt met behulp van de terraform destroy opdracht. Wanneer u hierom wordt gevraagd, voert u yes dit in om te bevestigen.

terraform destroy

De implementatie van de gateway-API voor toepassingsroutering uitschakelen met behulp van Azure-portal

Ga naar het menu >Ingress-profiel. Selecteer onder ToepassingsrouteringBeheren, schakel het selectievakje uit en selecteer Opslaan.

Resources opschonen met behulp van Azure-portal

Schakel onder Services, gateways en ingresses het selectievakje in naast de gateway of HTTPRoute-resource die u wilt verwijderen en selecteer vervolgens Verwijderen op de werkbalk.