Gateway API для Managed Service for Kubernetes

Application Load Balancer предоставляет инструмент для создания и управления балансировщиками нагрузки в кластерах Yandex Managed Service for Kubernetes — Gateway API. Подробнее о проекте Gateway API см. на его сайте.

После установки Gateway API вы сможете создать с его помощью ресурс Gateway, а также связанные с ним ресурсы HTTPRoute и GRPCRoute:

• Ресурсом Gateway управляет оператор кластера. В этом ресурсе описывается прием входящего трафика и правила, по которым выбираются маршруты для этого трафика — ресурсы HTTPRoute и GRPCRoute. Для приема трафика по Gateway создается L7-балансировщик, а для маршрутизации к балансировщику привязываются HTTP-роутеры.
• Ресурсами HTTPRoute и GRPCRoute управляют разработчики приложений — сервисов Kubernetes. HTTPRoute и GRPCRoute — описание маршрута для принятого входящего трафика. В соответствии с этим описанием трафик может быть отправлен в сервис Kubernetes, выполняющий роль бэкенда, или перенаправлен на другой URI. По HTTPRoute и GRPCRoute создаются виртуальные хосты и маршруты в HTTP-роутерах, а также группы бэкендов.

Полную конфигурацию ресурсов для Gateway API см. в следующих разделах:

• Gateway — правила приема входящего трафика и выбора маршрутов (HTTPRoute) для этого трафика.
• GatewayPolicy — политика применения правил ресурса Gateway, конфигурация обработки входящего трафика.
• YCCertificate — параметры сертификата Certificate Manager для настройки TLS-соединений в ресурсе Gateway.
• HTTPRoute и GRPCRoute — правила маршрутизации трафика по бэкендам или его перенаправления.
• RoutePolicy — политика применения правил ресурса HTTPRoute и настройка правил доступа к бэкендам.
• YCStorageBucket — параметры бакета Object Storage для настройки бэкенда в ресурсе HTTPRoute.
• Service — описание сервисов Kubernetes, используемых в качестве бэкендов.

Порядок маршрутов в виртуальных хостахПорядок маршрутов в виртуальных хостах

Порядок маршрутов в виртуальных хостах определяется алгоритмами, описанными в спецификации Gateway API. Эти алгоритмы отличаются для HTTP-запросов и gRPC-вызовов.

Если после применения этих условий среди маршрутов из разных ресурсов остаются маршруты с равным приоритетом, то сначала больший приоритет получают старые маршруты, а затем — маршруты в алфавитном порядке по формату {namespace}/{name}.

В случае, если в пределах одного HTTPRoute/GRPCRoute все еще остаются маршруты с равным приоритетом, предпочтение отдается первому подходящему правилу в порядке их перечисления с учетом предыдущих критериев.

Порядок маршрутов может влиять на логику обработки запросов/вызовов.

Пример конфигурацииПример конфигурации

Ниже приведен пример конфигурации ресурсов Gateway и HTTPRoute. По ней будет создан балансировщик, принимающий HTTPS-трафик и распределяющий его по двум сервисам в зависимости от пути в URI запроса.

---
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: alb-gwapi-gw
spec:
  gatewayClassName: yc-df-class
  listeners:
    - name: alb-gwapi-listener
      protocol: HTTPS
      port: 443
      hostname: <доменное_имя>
      allowedRoutes:
        namespaces:
          from: Selector
          selector:
            matchLabels:
              gatewayName: alb-gwapi-gw
      tls:
        certificateRefs:
          - kind: Secret
            group: ""
            name: alb-gwapi-cert
            namespace: alb-gwapi-ns

---
apiVersion: v1
kind: Namespace
metadata:
  name: alb-gwapi-apps-ns
  labels:
    gatewayName: alb-gwapi-gw

---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: alb-gwapi-route
  namespace: alb-gwapi-apps-ns
spec:
  hostnames:
    - "<доменное_имя>"
  parentRefs:
    - name: alb-gwapi-gw
      namespace: default
  rules:
    - matches:
        - path: 
            type: PathPrefix
            value: /app1
      backendRefs:
        - name: alb-demo-1
          port: 80
    - matches:
        - path:
            type: PathPrefix
            value: /app2
      backendRefs:
        - name: alb-demo-2
          port: 80
    - backendRefs: # Default match (implicit "/" path prefix)
        - name: alb-demo-2
          port: 80

Установка и требованияУстановка и требования

Для установки Gateway API требуются:

• Кластер Managed Service for Kubernetes.
• Группа узлов в кластере.
• Пространство имен в кластере для хранения ключа сервисного аккаунта.

Установить Gateway API можно по инструкции.

См. такжеСм. также

• Настройка групп безопасности для кластера Kubernetes и балансировщика.
• Сервисный аккаунт для работы контроллера.
• Gateway API в Yandex Cloud Marketplace.