← Вернуться в центр знаний

Ingress-NGINX после завершения поддержки: переход на Gateway API

Ingress-NGINX завершил поддержку в марте 2026 года: работающие установки не отключились, но больше не получают исправлений и патчей безопасности. Переход нельзя свести к замене манифеста — поведение аннотаций и сетевых политик нужно проверить явно.

И
Инженерная редакция ВирТЭКСистемная интеграция и эксплуатация

Найдите фактическое использование

Проверьте все кластеры, namespaces, Helm-релизы и GitOps-репозитории. Инвентаризируйте IngressClass, контроллеры, внешние балансировщики, сертификаты и DNS. Отдельно выгрузите аннотации: rewrite, auth, CORS, rate limit, canary, snippets, timeouts и ограничения размера тела часто определяют реальное поведение.

Для каждого маршрута зафиксируйте владельца, критичность, домен, backend, TLS, внешний IP, требования к исходному адресу и текущие SLO. Неуправляемый Ingress без владельца — риск миграции, а не повод перенести его автоматически.

Выберите реализацию Gateway API

Gateway API задаёт общую модель ресурсов, но dataplane и поддерживаемые расширения зависят от реализации. Сравните HTTPRoute, GRPCRoute, TLSRoute, политики, интеграцию с облачным балансировщиком, WAF, service mesh, наблюдаемость и жизненный цикл поставщика.

Проверьте поддерживаемый профиль и версию CRD. Используйте отдельный GatewayClass для платформенной команды, Gateway для инфраструктурной границы и Route для владельца приложения. Эта модель позволяет разделить полномочия лучше, чем общий набор аннотаций.

Переведите поведение, а не YAML

Ingress2Gateway помогает создать начальную конфигурацию, но не гарантирует эквивалентность нестандартных аннотаций. Составьте таблицу: старое правило, новый ресурс или policy, ожидаемое поведение, тест и владелец исключения.

Особенно проверьте порядок совпадения путей, regex и rewrite, заголовки, client IP, WebSocket и gRPC, sticky sessions, mTLS, ограничения запроса, редиректы и обработку ошибок. Сниппеты нельзя переносить без разбора: часть логики должна стать политикой, фильтром или функцией приложения.

Мигрируйте параллельно

Разверните новый контроллер рядом, выдайте отдельный адрес и прогоните синтетические и интеграционные тесты. Переводите DNS с контролируемым TTL либо используйте балансировщик для распределения части трафика. Сравнивайте коды ответа, задержку, TLS, метрики backend и журналы безопасности.

Определите критерии остановки, быстрый возврат и окно наблюдения. Критические маршруты переводятся группами, чтобы ошибка общей политики не затронула все сервисы одновременно.

Завершите вывод безопасно

После миграции убедитесь, что на старом адресе нет трафика, удалите публичные точки входа и избыточные права, сохраните конфигурацию и доказательства тестов. Обновите шаблоны, CI-проверки и каталог платформы, чтобы новые Ingress не появлялись снова.

Успешный переход означает не только работающий маршрут, но и понятное разделение полномочий, поддерживаемую реализацию, воспроизводимые тесты и план обновления Gateway API.

Нужна архитектура
под вашу задачу?

Разберём исходные данные, риски и ограничения, затем предложим обоснованный вариант решения.

Обсудить с инженером↗︎