Konfigurowanie ruchu przychodzącego przy użyciu interfejsu Gateway API platformy Kubernetes za pomocą dodatku routingu aplikacji dla Azure Kubernetes Service (AKS)

Aktualizowanie wersji interfejsu wiersza polecenia platformy Azure

Musisz użyć wersji azure-cli2.86.0 lub nowszej. Uruchom polecenie az --version , aby znaleźć swoją azure-cli wersję i uruchomić az upgrade polecenie , aby uaktualnić.

Włącz interfejsy CRD zarządzanego interfejsu Gateway API

Włącz instalację interfejsu API usługi Managed Gateway. Korzystanie z samodzielnie zarządzanych CRD bramy API z dodatkiem routingu aplikacji nie jest obsługiwane.

Automatyczne zachowanie domyślne w usłudze AKS (AKS 1.36 i nowsze)

W nowych klastrach AKS Automatic działających w wersji AKS 1.36 lub nowszej interfejs API Kubernetes Gateway za pośrednictwem dodatku routingu aplikacji jest domyślnie włączony.

Zwykle nie trzeba uruchamiać polecenia włączania funkcji, chyba że:

• Korzystanie z istniejącego klastra.
• Korzystanie ze starszej wersji AKS
• Ponowne włączenie funkcji po jej wyłączeniu.

Włącz implementację interfejsu API bramy routingu aplikacji

Włączanie podczas tworzenia klastra

Uruchom następujące polecenie, aby włączyć implementację interfejsu API bramy routingu aplikacji podczas tworzenia klastra usługi AKS Standard:

# 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

Włącz dla istniejącego klastra

Uruchom następujące polecenie, aby włączyć implementację interfejsu API usługi Application Routing Gateway dla istniejącego klastra:

# 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

Powinieneś zobaczyć istiod zasobniki w aks-istio-system przestrzeni nazw.

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

Również powinieneś zobaczyć, jak ValidatingWebhookConfiguration zostaje wdrożony.

kubectl get validatingwebhookconfiguration

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

Jeśli masz włączoną instalację interfejsu API bramy zarządzanej, powinien zostać również utworzony obiekt ConfigMap do dostosowywania bramy Istio.

kubectl get cm -n aks-istio-system

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

Konfigurowanie ingress przy użyciu Gateway Kubernetes

Wdrażanie przykładowej aplikacji

Najpierw wdróż przykładową httpbin aplikację w default przestrzeni nazw:

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

Tworzenie bramy Kubernetes i usługi HTTPRoute

Następnie wdróż konfigurację interfejsu API bramy w przestrzeni nazw z ustawionym default na gatewayClassName.

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

Sprawdź, czy utworzono element Deployment, Service, HorizontalPodAutoscaleri PodDisruptionBudget dla elementu 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

Wysyłanie żądania do przykładowej aplikacji

Na koniec spróbuj wysłać curl żądanie do httpbin aplikacji. Najpierw ustaw zmienną środowiskową INGRESS_HOST :

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

Następnie spróbuj wysłać żądanie HTTP do :httpbin

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

Odpowiedź HTTP 200 powinna być widoczna.

Aby użyć narzędzia Terraform do utworzenia klastra usługi AKS z włączoną implementacją interfejsu API routingu aplikacji, potrzebne są następujące elementy:

• Zainstalowano wersję 1.9.0 programu Terraform lub nowszą.
• Zainstalowany i uwierzytelniony Azure CLI. Uruchom polecenie az --version , aby znaleźć swoją azure-cli wersję i uruchomić az upgrade polecenie , aby uaktualnić. Użyjesz Azure CLI, aby nawiązać połączenie z klastrem po utworzeniu go przez narzędzie Terraform.
• zainstalowano narzędzie kubectl. Możesz zainstalować ją lokalnie przy użyciu az aks install-cli polecenia . Używasz kubectl, aby wdrożyć przykładową aplikację i zasoby interfejsu Gateway API.

Wdróż klaster AKS z implementacją interfejsu Gateway API routingu aplikacji za pomocą narzędzia Terraform

W tej sekcji pokazano, jak za pomocą narzędzia Terraform wdrożyć klaster usługi AKS z instalacją interfejsu API usługi Managed Gateway i włączoną implementacją interfejsu API routingu aplikacji.

Ten przykład wdraża:

• Grupa zasobów.
• Klaster usługi AKS, który korzysta z wtyczki sieciowej Azure CNI i standardowego modułu równoważenia obciążenia.
• Instalacja interfejsu API usługi Managed Gateway i implementacja interfejsu API routingu aplikacji są włączone w klastrze za pośrednictwem dostawcy AzAPI. Włączenie obu ustawień powoduje, że zarządzana przez AKS klasa approuting-istio GatewayClass jest dostępna w klastrze.

1. Utwórz katalog, aby przetestować i uruchomić przykładowy kod narzędzia Terraform, a następnie ustaw go jako bieżący katalog.

2. Utwórz plik o nazwie main.tfi wstaw następujący 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. Zainicjuj narzędzie Terraform, uruchamiając polecenie terraform init. To polecenie pobiera dostawców platformy Azure wymaganych do zarządzania zasobami Azure za pomocą narzędzia Terraform.

   terraform init
   

4. Sformatuj i zweryfikuj konfigurację, uruchamiając polecenia terraform fmt i terraform validate.

   terraform fmt
   terraform validate
   

5. Utwórz plan wykonywania narzędzia Terraform, uruchamiając terraform plan polecenie . To polecenie pokazuje zasoby tworzone lub modyfikowane przez program Terraform w ramach subskrypcji Azure.

   terraform plan
   

6. Zastosuj plan wykonania Terraform, uruchamiając polecenie terraform apply. To polecenie tworzy zasoby zdefiniowane w main.tf pliku w subskrypcji Azure. Po wyświetleniu monitu wprowadź polecenie yes , aby potwierdzić.

   terraform apply
   

Nawiązywanie połączenia z klastrem usługi AKS przy użyciu narzędzia Terraform

1. Pobierz nazwy grup zasobów i klastrów z danych wyjściowych programu Terraform.

   terraform output -raw resource_group_name
   terraform output -raw cluster_name
   

2. Skonfiguruj kubectl, aby połączyć się z klastrem za pomocą polecenia az aks get-credentials. To polecenie pobiera poświadczenia i konfiguruje Kubernetes CLI do ich użycia. Zamień <resource-group-name> i <cluster-name> na wartości z poprzedniego kroku. Możesz też uruchomić polecenie terraform output -raw get_credentials_command , aby uzyskać pełne, gotowe do uruchomienia polecenie.

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

3. Sprawdź, czy klaster jest uruchomiony, uruchamiając kubectl get nodes polecenie .

   kubectl get nodes
   

Weryfikowanie konfiguracji interfejsu API bramy przy użyciu narzędzia Terraform

1. Upewnij się, że pody istiod działają w przestrzeni nazw aks-istio-system.

   kubectl get pods -n aks-istio-system
   

2. Upewnij się, że klasa approuting-istio GatewayClass istnieje i została zaakceptowana.

   kubectl get gatewayclass
   

   Klasa approuting-istio GatewayClass powinna zwracać wartość True w kolumnie ACCEPTED.

Konfigurowanie ruchu przychodzącego przy użyciu bramy Kubernetes z programem Terraform

Wdrażanie przykładowej aplikacji przy użyciu narzędzia Terraform

Wdróż przykładową aplikację httpbin w przestrzeni nazw default:

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

Sprawdź, czy pod httpbin i usługa są dostępne:

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

Tworzenie zasobów bramy i usługi HTTPRoute przy użyciu programu Terraform

Przykładowa implementacja interfejsu Gateway API do routingu aplikacji zawiera manifest Gateway, który tworzy odbiornik HTTP na porcie 80 i używa zarządzanej przez AKS klasy GatewayClass approuting-istio.

1. Utwórz plik o nazwie gateway.yamli wstaw następujący 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. Zastosuj konfigurację Gateway :

   kubectl apply -f gateway.yaml
   

   Przykład zawiera także manifest HTTPRoute, który kieruje żądania dla httpbin.example.com/get do usługi httpbin na porcie 8000.

3. Utwórz plik o nazwie httproute.yamli wstaw następujący 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. Zastosuj konfigurację HTTPRoute :

   kubectl apply -f httproute.yaml
   

Sprawdź, czy utworzono element Deployment, Service, HorizontalPodAutoscaleri PodDisruptionBudget dla elementu 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

Wysyłanie żądania do przykładowej aplikacji przy użyciu narzędzia Terraform

Poczekaj, aż Gateway zaraportuje stan Programmed, a następnie pobierz jego adres zewnętrzny:

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

Następnie wyślij żądanie do httpbin za pośrednictwem bramy Gateway:

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

Odpowiedź HTTP 200 powinna być widoczna.

Wyłączanie implementacji interfejsu API bramy routingu aplikacji

Uruchom następujące polecenie, aby wyłączyć implementację interfejsu API usługi Application Routing Gateway:

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

Uprzątnij zasoby

Uruchom następujące polecenia, aby usunąć zasoby Gateway i HTTPRoute:

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

Jeśli utworzono obiekt ConfigMap w celu dostosowania obiektu Gateway, uruchom następujące polecenie, aby usunąć obiekt ConfigMap:

kubectl delete configmap gw-options

Jeśli utworzono obiekt SecretProviderClass i obiekt Secret do terminacji TLS, usuń następujące zasoby:

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

Czyszczenie zasobów przy użyciu narzędzia Terraform

W tej sekcji wdrożono przykładową aplikację ograniczoną do przestrzeni nazw oraz zasoby interfejsu Gateway API. Jeśli nie potrzebujesz już tych zasobów platformy Kubernetes, usuń je przed usunięciem podstawowej infrastruktury Azure.

Usuń HTTPRoute, Gateway i przykładową aplikację za pomocą polecenia 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

Usuń zasoby Azure utworzone przez program Terraform przy użyciu terraform destroy polecenia . Po wyświetleniu monitu wprowadź polecenie yes , aby potwierdzić.

terraform destroy