#Настройка маршрута GatewayAPI

#Предварительные требования

Пожалуйста, убедитесь, что вы ознакомились с документацией по установке перед продолжением.

#Настройка через веб-консоль

1. Перейдите в Alauda Container Platform -> Networking -> Routes
2. Нажмите кнопку Create Route

#Создание HTTPRoute

#Создание TCP/UDP маршрута

#Настройка через YAML

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: demo-443
  namespace: demo
spec:
  hostnames:
    - example.com
  parentRefs:
    - group: gateway.networking.k8s.io
      kind: Gateway
      name: demo
      sectionName: https
  rules:
    - backendRefs:
        - group: ''
          kind: Service
          name: echo-resty
          namespace: demo-space
          port: 80
          weight: 100
      filters: [] 
      matches:
        - path:
            type: Exact
            value: /a
      sessionPersistence:
        type: Cookie
        sessionName: a
---
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: TCPRoute
metadata:
  name: tcp
  namespace: demo-space
spec:
  parentRefs:
    - group: gateway.networking.k8s.io
      kind: Gateway
      name: demo
      sectionName: tcp
  rules:
    - backendRefs:
        - group: ''
          kind: Service
          name: echo-resty
          port: 80
          weight: 100
---
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: UDPRoute
metadata:
  name: udp
  namespace: demo
spec:
  parentRefs:
    - group: gateway.networking.k8s.io
      kind: Gateway
      name: demo
      namespace: demo
      sectionName: udp
  rules:
    - backendRefs:
        - group: ''
          kind: Service
          name: echo-resty
          namespace: demo
          port: 53
          weight: 100

#Введение

Каждый маршрут — это CR, определённый спецификацией GatewayAPI. Для подробной информации о полях и параметрах настройки каждого типа маршрута, пожалуйста, обратитесь к официальной документации: - HTTPRoute specification - TCPRoute specification - UDPRoute specification - GRPCRoute specification - TLSRoute specification

#Hostnames

Поле hostnames в маршруте представляет собой массив строк.
Оно следует правилам пересечения имён хостов.

#Publish to Listener

• sectionName — это имя слушателя.
• Маршруты могут быть прикреплены только к слушателям, поддерживающим их конкретный тип.
• По умолчанию маршруты могут быть прикреплены только к слушателям, где Gateway находится в том же namespace. Для прикрепления между namespace смотрите раздел прикрепление к gateway, созданному в другом namespace.

#Rules

Каждый маршрут может содержать несколько правил. Каждое правило состоит из следующих компонентов:

#Matches

Определяет условия, которые должны быть выполнены, чтобы запрос был маршрутизирован этим правилом.

Правило может содержать несколько совпадений:

• Каждое совпадение состоит из нескольких условий (например, путь, заголовки, параметры запроса, метод)
• Условия внутри одного совпадения используют логику AND (все должны быть выполнены)
• Совпадения между собой используют логику OR (достаточно выполнить любое совпадение)

Пример: Если Match-1 требует path=/api И header=v1, а Match-2 требует query=test, то запрос будет маршрутизирован, если он соответствует либо (path=/api И header=v1), либо (query=test).

#Типы условий совпадения

#Ссылки на условия совпадения

#Filters

Определяет преобразования или модификации, применяемые к запросам/ответам.

#Типы фильтров

Примечания:

• RequestRedirect и URLRewrite не могут использоваться одновременно в одном правиле
• ReplacePrefixMatch совместим только с PathPrefix в HTTPRouteMatch
• Имена заголовков нечувствительны к регистру согласно RFC 7230
• Несколько значений одного заголовка должны использовать формат с разделением запятыми согласно RFC 7230

#Ссылки на фильтры

#Backend

Определяет целевой сервис(ы), на которые должны перенаправляться подходящие запросы.

Каждый сервис может иметь поле weight для указания доли трафика, направляемой на этот сервис.

#Расширенные настройки правил HTTPRoute

Правила HTTPRoute поддерживают дополнительные параметры конфигурации, такие как политики повторных попыток, таймауты и другие параметры управления трафиком.

#Таймауты

#Повторные попытки

#Сессионная аффинность

Настраивает параметры сессионной аффинности, чтобы обеспечить маршрутизацию запросов от одного клиента к одному и тому же бэкенду.

#Следующий шаг

Задачи для Envoy Gateway

#Связанные задачи

• Как прикрепиться к слушателю, созданному в другом namespace