Ingress2gateway : migration simplifiée de Kubernetes Ingress vers Gateway API

L'outil Ingress2gateway est conçu pour simplifier la transition des ressources Kubernetes Ingress vers Gateway API, plus puissant et plus expressif. Il propose un processus de conversion automatisé et robuste, qui assure une migration fluide tout en limitant les interruptions.

Principales fonctionnalités :

✅ Conversion automatique

• Analyse intelligemment les ressources Ingress existantes et génère les configurations Gateway API équivalentes, y compris les ressources Gateway, HTTPRoute et BackendPolicy.
• Prend en charge les règles, annotations et configurations Ingress complexes en les traduisant vers les spécifications Gateway API correspondantes.

✅ Préservation des règles de routage :

• Mappe avec précision les chemins URL, les noms d'hôtes et les services backend depuis les règles Ingress vers les règles HTTPRoute.
• Garantit que le comportement du routage reste cohérent après la migration, ce qui évite les interruptions de service inattendues.
• Prend en charge diverses fonctionnalités de routage : correspondance de chemin (préfixe, exacte, regex), correspondance de nom d'hôte et routage basé sur les en-têtes.

✅ Compatibilité avec plusieurs contrôleurs Ingress

• L'outil prend actuellement en charge les providers apisix, cilium, ingress-nginx, istio, gce, kong et openapi, et la communauté travaille activement à en ajouter d'autres.

✅ Migration progressive :

• Permet une adoption incrémentale de Gateway API grâce à la conversion sélective des ressources Ingress.
• Prend en charge le mode dry-run pour prévisualiser les résultats de la conversion avant d'appliquer les changements au cluster.
• Permet de tester en parallèle les ressources Ingress et Gateway API.

Pour tester l'outil, il vous faut un cluster Kubernetes avec Gateway API installé. Plusieurs projets prennent en charge Gateway API, et certains fournisseurs cloud proposent même une implémentation entièrement managée.

Dans l'exemple qui suit, j'utilise Google Kubernetes Engine et le contrôleur Ingress par défaut ingress-gce de GKE.

Déploiement d'un workload et d'une ressource Ingress de démonstration

• Déployez le workload de démonstration httpbin.

---
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

Exemple de Deployment et de Service Kubernetes

• Créez une ressource Ingress pour le déploiement httpbin.

---
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

Exemple de ressource Ingress

Installer et exécuter ingress2gateway

• Suivez la documentation d'installation pour installer ingress2gateway, ou téléchargez le binaire depuis la page des releases.
• Exécutez ingress2gateway pour le provider concerné. L'outil lit les ressources Ingress et/ou les CRD spécifiques au provider depuis un cluster Kubernetes ou un fichier, puis génère sur stdout les ressources Gateway API équivalentes au format YAML/JSON.

Le résultat ressemble à ceci :

Exemple de ressources Gateway API générées par ingress2gateway

Remarque : ingress2gateway n'a pas vocation à recopier les annotations d'Ingress vers Gateway API. L'outil convertit plutôt les annotations en CRD Gateway ; certaines annotations et/ou CRD spécifiques aux providers, même très répandues, peuvent ne pas être prises en charge. Reportez-vous à la liste des providers pris en charge et à leur documentation.

Exemple de ressources Gateway API

• Vérifiez le manifeste généré pour vous assurer qu'il contient toutes les configurations nécessaires avant de l'appliquer en production. Réalisez un test de bout en bout avant de supprimer les ressources Ingress existantes.