CRD Gateway API (shturval-gateway-api-crds)
О сервисе
| Параметр | Значение |
|---|---|
| Название в интерфейсе | CRD модуля Gateway API |
| Системное название (идентификатор) | shturval-gateway-api-crds |
| Назначение в кластере | Установка CRD Gateway API (GatewayClass, Gateway, HTTPRoute, GRPCRoute и др.) для управления маршрутизацией трафика. |
| Критический | Да |
| Группа быстрой установки | Критические сервисы |
| Публичный репозиторий | Kubernetes Gateway API |
| Зависимости | — |
| Неймспейс | gateway-system |
Назначение
shturval-gateway-api-crds — чарт CRD Gateway API. Разворачивает в кластере CRD API-группы gateway.networking.k8s.io, необходимые для работы с GatewayClass, Gateway и маршрутами Gateway API в платформе «Штурвал».
Чарт не запускает контроллер маршрутизации — он только поставляет CRD. Обработку трафика выполняет контроллер, связанный с GatewayClass. Сервис критически важный: он устанавливается в кластер управления и в клиентский кластер. Если кластер принимает входящий трафик через Gateway API, контроллер Cilium уже включён — см. Контроллер Gateway API в Cilium.
При подключении контроллера Gateway API в кластер убедитесь в совместимости его версии с CRD. Чарт shturval-gateway-api-crds в платформе «Штурвал» 2.15 поставляет CRD Gateway API версии 1.6.1. Контроллер должен поддерживать эту версию спецификации.
Где настраивать
Чтобы проверить наличие установленного CRD или изменить конфигурацию уже установленного сервиса: кластер → раздел Сервисы и репозитории → Установленные сервисы → найдите CRD модуля Gateway API (shturval-gateway-api-crds) → Управлять.
Если сервис отсутствует, установить его в кластер: Доступные чарты → чарт shturval-gateway-api-crds → Установить. При конфигурировании установки создайте и выберите неймспейс gateway-system.
После успешного развёртывания shturval-gateway-api-crds в GUI станут доступны страницы настройки ресурсов Gateway API: в кластере Gateway Classes, Gateways и в неймспейсе Маршруты. Подробнее об обзоре Gateway API см. Gateway API.
Подробнее в документации: Gateway API, Kubernetes Gateway API.
Развернуть экспериментальную версию CRD
По умолчанию при установке сервиса поставляются CRDs Gateway API стабильной версии 1.6.1.
| CRD | API-группа | Версия API | Область | Версия |
|---|---|---|---|---|
| BackendTLSPolicy | gateway.networking.k8s.io | v1 | Namespaced | Стабильная |
| GatewayClass | gateway.networking.k8s.io | v1 | Cluster | Стабильная |
| Gateway | gateway.networking.k8s.io | v1 | Namespaced | Стабильная |
| GRPCRoute | gateway.networking.k8s.io | v1 | Namespaced | Стабильная |
| HTTPRoute | gateway.networking.k8s.io | v1 | Namespaced | Стабильная |
| ReferenceGrant | gateway.networking.k8s.io | v1beta1 | Namespaced | Стабильная |
| TCPRoute | gateway.networking.k8s.io | v1alpha2 | Namespaced | Экспериментальная |
| TLSRoute | gateway.networking.k8s.io | v1alpha3 | Namespaced | Экспериментальная |
| UDPRoute | gateway.networking.k8s.io | v1alpha2 | Namespaced | Экспериментальная |
| XBackendTrafficPolicy | gateway.networking.x-k8s.io | v1alpha1 | Namespaced | Экспериментальная |
| XListenerSet | gateway.networking.x-k8s.io | v1alpha1 | Namespaced | Экспериментальная |
| XMesh | gateway.networking.x-k8s.io | v1alpha1 | Cluster | Экспериментальная |
Чтобы развернуть CRDs экспериментальной версии, задайте параметр experimental: true.
При установке сервиса
При настройке конфигурации shturval-gateway-api-crds в блоке Спецификация сервиса укажите customvalues:
experimental: true
Если сервис уже установлен
Если в кластере уже развёрнут CRD модуля Gateway API (shturval-gateway-api-crds), примените ShturvalServicePatch:
apiVersion: ops.shturval.tech/v1beta2
kind: ShturvalServicePatch
metadata:
name: shturval-gateway-api-crds-experimental
spec:
shturvalServiceConfigName: shturval-gateway-api-crds
customvalues:
experimental: true
| Параметр | Описание | Тип | Пример |
|---|---|---|---|
metadata.name | Имя ShturvalServicePatch | string | shturval-gateway-api-crds-experimental |
customvalues.experimental | true — экспериментальный набор CRD; false — стабильный (по умолчанию) | boolean | true |
Как развернуть этот сервис — Как развернуть новый сервис.