Konfigurera ingress med Kubernetes Gateway-API:et via tillägget för programroutning för Azure Kubernetes Service (AKS)

Uppdatera Azure CLI-versionen

Du måste använda azure-cli version 2.86.0 eller högre. Kör az --version för att hitta din azure-cli version och kör az upgrade för att uppgradera.

Aktivera CRD:erna för Managed Gateway API

Aktivera API-installationen för Managed Gateway. Användning av självhanterade GATEWAY-API CRD:er med tillägget för programroutning stöds inte.

AKS Automatiskt standardbeteende (AKS 1.36 och senare)

I nya AKS-automatiska kluster som kör AKS 1.36 eller senare aktiveras Kubernetes Gateway API via tillägget för programroutning som standard.

Du behöver vanligtvis inte köra kommandot för funktionsaktivering om du inte gör följande:

• Använda ett befintligt kluster.
• Köra en tidigare AKS-version.
• Återaktivera funktionen när den har inaktiverats.

Aktivera implementeringen av gateway-API:et för programroutning

Aktivera när klustret skapas

Kör följande kommando för att aktivera implementeringen av gateway-API:et för programroutning när AKS Standard-klustret skapas:

# 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

Aktivera för ett befintligt kluster

Kör följande kommando för att aktivera implementeringen av gateway-API:et för programroutning för ett befintligt kluster:

# 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

Du bör se istiod poddar i aks-istio-system namnområdet:

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

Du bör också se ValidatingWebhookConfiguration bli distribuerad:

kubectl get validatingwebhookconfiguration

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

Om du har aktiverat API-installationen för Managed Gateway bör du även se anpassningen av Istio Gateway ConfigMap skapas:

kubectl get cm -n aks-istio-system

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

Konfigurera ingress med en Kubernetes Gateway

Distribuera exempelprogram

Distribuera först exempelprogrammet httpbin i default namnområdet:

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

Skapa Kubernetes Gateway och HTTPRoute

Distribuera sedan en gateway-API-konfiguration i default-namnrymden med gatewayClassName satt till 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

Kontrollera att en Deployment, Service, HorizontalPodAutoscaleroch PodDisruptionBudget skapas för 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

Skicka begäran till exempelapplikationen

Försök slutligen skicka en curl begäran till programmet httpbin . INGRESS_HOST Ange först miljövariabeln:

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}')

Försök sedan skicka en HTTP-begäran till httpbin:

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

Du bör se ett HTTP 200 svar.

Om du vill använda Terraform för att skapa ett AKS-kluster med implementeringen av gateway-API:et för programroutning aktiverad behöver du:

• Terraform-versionen1.9.0 eller senare installerad.
• Azure CLI installerat och autentiserat. Kör az --version för att hitta din azure-cli version och kör az upgrade för att uppgradera. Du använder Azure CLI för att ansluta till klustret när Terraform har skapat det.
• kubectl installerat. Du kan installera den lokalt med hjälp az aks install-cli av kommandot . Du använder kubectl för att distribuera exempelprogrammet och gateway-API-resurserna.

Distribuera ett AKS-kluster med implementeringen av gateway-API:et för programroutning med Terraform

Det här avsnittet visar hur du använder Terraform för att distribuera ett AKS-kluster med API-installationen för Managed Gateway och implementeringen av gateway-API:et för programroutning aktiverat.

Det här exemplet distribuerar:

• En resursgrupp.
• Ett AKS-kluster som använder Azure CNI-nätverksinsticksprogram och en standardlastbalanserare.
• Api-installationen för Managed Gateway och implementeringen av gateway-API:et för programdirigering, båda aktiverade i klustret via AzAPI-providern. Om du aktiverar båda inställningarna blir AKS-hanterad approuting-istio GatewayClass tillgänglig i klustret.

1. Skapa en katalog för att testa och köra Terraform-exempelkoden och gör den till den aktuella katalogen.

2. Skapa en fil med namnet main.tfoch infoga följande kod:

   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. Initiera Terraform genom att terraform init köra kommandot . Det här kommandot laddar ned de Azure providers som krävs för att hantera Azure resurser med Terraform.

   terraform init
   

4. Formatera och verifiera konfigurationen genom att köra kommandona terraform fmt och terraform validate .

   terraform fmt
   terraform validate
   

5. Skapa en Terraform-exekveringsplan genom att köra kommandot terraform plan. Det här kommandot visar de resurser som Terraform skapar eller ändrar i din Azure prenumeration.

   terraform plan
   

6. Tillämpa Terraform-körningsplanen genom att köra kommandot terraform apply. Det här kommandot skapar de resurser som definierats i main.tf filen i din Azure-prenumeration. När du uppmanas till det anger du yes för att bekräfta.

   terraform apply
   

Ansluta till AKS-klustret med Terraform

1. Hämta resursgruppen och klusternamnen från Terraform-utdata.

   terraform output -raw resource_group_name
   terraform output -raw cluster_name
   

2. Konfigurera kubectl så att det ansluter till ditt kluster genom att använda kommandot az aks get-credentials. Det här kommandot laddar ned autentiseringsuppgifter och konfigurerar Kubernetes CLI för att använda dem. Ersätt <resource-group-name> och <cluster-name> med värdena från föregående steg. Du kan också köra terraform output -raw get_credentials_command för att hämta det fullständiga kommandot ready-to-run.

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

3. Kontrollera att klustret är igång genom att köra kommandot kubectl get nodes.

   kubectl get nodes
   

Verifiera gateway-API-konfigurationen med hjälp av Terraform

1. Bekräfta att istiod poddarna körs i aks-istio-system namnområdet.

   kubectl get pods -n aks-istio-system
   

2. Bekräfta att approuting-istio GatewayClass finns och godkänns.

   kubectl get gatewayclass
   

   approuting-istio GatewayClass ska returnera True i kolumnen ACCEPTED.

Konfigurera ingress med hjälp av en Kubernetes Gateway med Terraform

Distribuera exempelprogrammet med terraform

Distribuera exempelprogrammet httpbin i default namnområdet:

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

Kontrollera att httpbin podden och tjänsten är tillgängliga:

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

Skapa gateway- och HTTPRoute-resurser med Terraform

Gateway API-implementeringsexemplet för programroutning innehåller ett Gateway-manifest som skapar en HTTP-lyssnare på port 80 och använder den AKS-hanterade approuting-istio GatewayClass.

1. Skapa en fil med namnet gateway.yamloch infoga följande kod:

   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. Tillämpa Gatewaykonfigurationen:

   kubectl apply -f gateway.yaml
   

   Exemplet innehåller också ett HTTPRoute manifest som dirigerar begäranden till httpbin.example.com/gethttpbin tjänsten på port 8000.

3. Skapa en fil med namnet httproute.yamloch infoga följande kod:

   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. Tillämpa HTTPRoutekonfigurationen:

   kubectl apply -f httproute.yaml
   

Kontrollera att en Deployment, Service, HorizontalPodAutoscaleroch PodDisruptionBudget skapas för 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

Skicka en begäran till exempelprogrammet med Terraform

Vänta tills gatewayen rapporterar ett Programmed villkor och hämta sedan dess externa adress:

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}')

Skicka sedan en begäran till httpbin via gatewayen:

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

Du bör se ett HTTP 200 svar.

Inaktivera implementeringen av gateway-API:et för programroutning

Kör följande kommando för att inaktivera implementeringen av gateway-API:et för programroutning:

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

Rensa resurser

Kör följande kommandon för att ta bort Gateway resurserna och HTTPRoute :

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

Om du har skapat en ConfigMap för att anpassa din Gatewaykör du följande kommando för att ta bort ConfigMap:

kubectl delete configmap gw-options

Om du har skapat en SecretProviderClass och en hemlighet som ska användas för TLS-avslutning tar du bort följande resurser:

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

Rensa resurser med Terraform

I det här avsnittet driftsatte du en exempelapplikation som var begränsad till ett namnområde och Gateway API-resurser. Om du inte längre behöver dessa Kubernetes-resurser tar du bort dem innan du tar bort den underliggande Azure infrastrukturen.

Ta bort HTTPRoute, Gateway och exempelprogrammet med kommandot kubectl delete:

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

Ta bort Azure-resurserna som skapats av Terraform med kommandot terraform destroy. När du uppmanas till det anger du yes för att bekräfta.

terraform destroy