Ingress2gateway: Der einfache Weg von Kubernetes Ingress zur Gateway API

Das Tool Ingress2gateway wurde entwickelt, um den Umstieg von Kubernetes-Ingress-Ressourcen auf die leistungsfähigere und ausdrucksstärkere Gateway API zu vereinfachen. Es bietet einen robusten, automatisierten Konvertierungsprozess für eine reibungslose Migration mit minimalen Auswirkungen auf den Betrieb.

Wichtigste Funktionen und Möglichkeiten:

✅ Automatische Konvertierung

• Analysiert vorhandene Ingress-Ressourcen intelligent und erzeugt äquivalente Gateway-API-Konfigurationen, einschließlich Gateway-, HTTPRoute- und BackendPolicy-Ressourcen.
• Verarbeitet komplexe Ingress-Regeln, Annotationen und Konfigurationen und überführt sie in die passenden Gateway-API-Spezifikationen.

✅ Erhält Routing-Regeln:

• Bildet URL-Pfade, Hostnamen und Backend-Services aus Ingress-Regeln präzise auf HTTPRoute-Regeln ab.
• Sorgt dafür, dass das Routing-Verhalten nach der Migration konsistent bleibt und unerwartete Ausfälle vermieden werden.
• Unterstützt diverse Routing-Funktionen wie Path Matching (Prefix, Exact, Regex), Hostname-Matching und Header-basiertes Routing.

✅ Unterstützt verschiedene Ingress-Controller

• Aktuell werden die Provider apisix, cilium, ingress-nginx, istio, gce, kong und openapi unterstützt – die Community arbeitet aktiv an weiteren.

✅ Ermöglicht eine schrittweise Migration:

• Erlaubt die schrittweise Einführung der Gateway API durch selektive Konvertierung einzelner Ingress-Ressourcen.
• Bietet einen Dry-Run-Modus, mit dem sich Konvertierungsergebnisse vor dem Anwenden im Cluster prüfen lassen.
• Ermöglicht den parallelen Betrieb und Test von Ingress- und Gateway-API-Ressourcen.

Um das Tool zu testen, benötigen Sie einen Kubernetes-Cluster mit installierter Gateway API. Mehrere Projekte unterstützen die Gateway API, einige Cloud-Anbieter stellen sogar eine vollständig verwaltete Implementierung bereit.

Im folgenden Beispiel verwende ich Google Kubernetes Engine sowie den standardmäßigen Ingress-Controller ingress-gce in GKE.

Beispiel-Workload und Ingress-Ressource bereitstellen

• Stellen Sie den Beispiel-Workload httpbin bereit.

---
apiVersion: v1
kind: Service
metadata:
  name: httpbin
  labels:
    app: httpbin
spec:
  ports:
  - name: http
    port: 8000
    targetPort: 80
  selector:
    app: httpbin
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: httpbin
spec:
  replicas: 1
  selector:
    matchLabels:
      app: httpbin
  template:
    metadata:
      labels:
        app: httpbin
    spec:
      containers:
      - image: docker.io/kennethreitz/httpbin
        imagePullPolicy: IfNotPresent
        name: httpbin
        ports:
        - containerPort: 80

Beispielhaftes Kubernetes-Deployment und -Service

• Erstellen Sie eine Ingress-Ressource für das httpbin-Deployment.

---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: httpbin-ingress
  namespace: default
spec:
  rules:
  - host: httpbin.example.com
    http:
      paths:
      - backend:
          service:
            name: httpbin
            port:
              number: 8000
        path: /
        pathType: Prefix

Beispielhafte Ingress-Ressource

Ingress2gateway installieren und ausführen

• Folgen Sie der Installationsanleitung, um ingress2gateway zu installieren, oder laden Sie das Binary auf der Releases-Seite herunter.
• Führen Sie ingress2gateway für Ihren jeweiligen Provider aus. Das Tool liest die Ingress-Ressourcen und/oder providerspezifischen CRDs aus einem Kubernetes-Cluster oder einer Datei und gibt die entsprechenden Gateway-API-Ressourcen im YAML- oder JSON-Format auf stdout aus.

Die Ausgabe sieht etwa so aus:

Mit ingress2gateway erzeugte Beispiel-Gateway-API-Ressourcen

Hinweis: Ingress2gateway ist nicht dafür gedacht, Annotationen 1:1 von Ingress in die Gateway API zu übernehmen. Stattdessen überführt das Tool die Annotationen in Gateway-CRDs; weit verbreitete providerspezifische Annotationen und/oder CRDs werden möglicherweise noch nicht unterstützt. Eine Übersicht der aktuell unterstützten Provider und der zugehörigen Dokumentation finden Sie unter supported providers.

Beispielhafte Gateway-API-Ressourcen

• Prüfen Sie das generierte Manifest sorgfältig und stellen Sie sicher, dass alle erforderlichen Konfigurationen enthalten sind, bevor Sie es in Ihrer Produktionsumgebung einsetzen. Führen Sie einen End-to-End-Test durch, bevor Sie die bestehenden Ingress-Ressourcen entfernen.