Преобразование ресурсов Ingress в ресурсы Gateway API c помощью ingress2gateway

При переходе с Ingress на Kubernetes Gateway API можно использовать утилиту ingress2gateway, которая преобразует существующие ресурсы Ingress в ресурсы Gateway API — Gateway и HTTPRoute.

1. Установите утилиту ingress2gateway:

   1
   VERSION=v0.5.0
   2
   
   3
   curl -LO "https://github.com/kubernetes-sigs/ingress2gateway/releases/download/${VERSION}/ingress2gateway_Linux_x86_64.tar.gz"
   4
   
   5
   tar -xzvf "ingress2gateway_Linux_x86_64.tar.gz"
   6
   
   7
   chmod +x ./ingress2gateway
   8
   
   9
   sudo install -o root -g root -m 0755 ingress2gateway /usr/local/bin/ingress2gateway

2. Убедитесь, что утилита установлена:

   1
   ingress2gateway version

   Ожидаемый результат:

   1
   ingress2gateway version: dev
   2
   Built with Go version: go1.24.6

3. Сконвертируйте манифест ресурса Ingress:

   1
   ingress2gateway print \
   2
   --providers=<провайдер — например, ingress-nginx> \
   3
   --input-file=<путь к файлу с исходным манифестом> \
   4
   > <файл, в который будут сохранены новые манифесты>

   Список доступных провайдеров приведен в документации.

   В файл будут сохранены манифесты ресурсов Gateway и HTTPRoute. Перед применением в кластере проверьте и при необходимости отредактируйте новые манифесты.

   Пример исходного манифеста

   1
   apiVersion: networking.k8s.io/v1
   2
   kind: Ingress
   3
   metadata:
   4
   name: shop
   5
   namespace: demo
   6
   spec:
   7
   ingressClassName: nginx
   8
   tls:
   9
   - hosts:
   10
       - shop.example.com
   11
       secretName: shop-tls
   12
   rules:
   13
   - host: shop.example.com
   14
       http:
   15
       paths:
   16
       - path: /
   17
           pathType: Prefix
   18
           backend:
   19
           service:
   20
               name: shop-frontend
   21
               port:
   22
               number: 80
   23
       - path: /api
   24
           pathType: Prefix
   25
           backend:
   26
           service:
   27
               name: shop-api
   28
               port:
   29
               number: 8080

   Пример результата

   1
   apiVersion: gateway.networking.k8s.io/v1
   2
   kind: Gateway
   3
   metadata:
   4
   annotations:
   5
       gateway.networking.k8s.io/generator: ingress2gateway-dev
   6
   name: nginx
   7
   namespace: demo
   8
   spec:
   9
   gatewayClassName: nginx
   10
   listeners:
   11
   - hostname: shop.example.com
   12
       name: shop-example-com-http
   13
       port: 80
   14
       protocol: HTTP
   15
   - hostname: shop.example.com
   16
       name: shop-example-com-https
   17
       port: 443
   18
       protocol: HTTPS
   19
       tls:
   20
       certificateRefs:
   21
       - group: null
   22
           kind: null
   23
           name: shop-tls
   24
   status: {}
   25
   ---
   26
   apiVersion: gateway.networking.k8s.io/v1
   27
   kind: HTTPRoute
   28
   metadata:
   29
   annotations:
   30
       gateway.networking.k8s.io/generator: ingress2gateway-dev
   31
   name: shop-shop-example-com
   32
   namespace: demo
   33
   spec:
   34
   hostnames:
   35
   - shop.example.com
   36
   parentRefs:
   37
   - name: nginx
   38
   rules:
   39
   - backendRefs:
   40
       - name: shop-frontend
   41
       port: 80
   42
       matches:
   43
       - path:
   44
           type: PathPrefix
   45
           value: /
   46
   - backendRefs:
   47
       - name: shop-api
   48
       port: 8080
   49
       matches:
   50
       - path:
   51
           type: PathPrefix
   52
           value: /api
   53
   status:
   54
   parents: []

4. Примените новые манифесты:

   1
   kubectl apply -f <путь к файлу с новыми манифестами>