Ingress-nginx больше не поддерживается: как перенести входящий трафик Kubernetes без поломки сайта и API
С марта 2026 года проект Kubernetes больше не выпускает для community-контроллера ingress-nginx ни исправлений ошибок, ни патчей безопасности. Существующие установки продолжают работать, поэтому проблема не видна, пока не появится уязвимость или несовместимость [1].
Безопасный переход выглядит так:
- Подтвердить, что в кластере работает именно
kubernetes/ingress-nginx, а не NGINX Ingress Controller от F5. - Выгрузить все Ingress, аннотации, глобальный ConfigMap и параметры запуска контроллера — это и есть ваша реальная конфигурация входящего трафика.
- Отдельно проверить авторизацию, WebSocket, загрузку файлов, тайм-ауты, IP клиента, лимиты и TLS — именно здесь новые контроллеры ведут себя иначе.
- Выбрать Gateway API или другой контроллер по результатам тестов на ваших сценариях, а не по факту «YAML применился».
- Поднять новый контроллер параллельно, прогнать тестовый трафик, сравнить коды ответов и задержки, затем переключать домены по одному.
- До последнего держать старый контроллер в рабочем состоянии как точку отката и подтверждать результат через контрольные бизнес-операции: вход, корзина, оплата, загрузка документа, обмен с учётной системой.
Кому полезна статья: компаниям, у которых сайт, личный кабинет или API работают в Kubernetes, — интернет-магазинам, SaaS-сервисам и DevOps-командам, которые отвечают за входящий трафик.
Что произошло и почему это касается бизнеса
В ноябре 2025 года SIG Network и комитет по реагированию на инциденты безопасности Kubernetes объявили о выводе ingress-nginx из эксплуатации. Поддержка «по возможности» продолжалась до марта 2026 года; после этого проект не выпускает релизы, не исправляет ошибки и не закрывает новые уязвимости. Репозитории переведены в режим только для чтения, а Helm-чарты и образы остаются доступными [1].
Причины две. Во-первых, проект годами поддерживали один-два человека в свободное время. Во-вторых, гибкость, сделавшая контроллер популярным, превратилась в долг: например, аннотации со «сниппетами», позволяющие вставлять произвольные директивы NGINX, теперь считаются серьёзной проблемой безопасности [1]. Документация самого контроллера предупреждает, что в многопользовательских кластерах такие сниппеты могут дать пользователю с ограниченными правами доступ ко всем секретам кластера [2].
Масштаб значительный. В январе 2026 года руководящий комитет Kubernetes вместе с комитетом по безопасности выпустил отдельное заявление; по данным телеметрии Datadog, на которые оно ссылается, ingress-nginx использовался примерно в половине облачных сред. В том же заявлении прямо сказано, что готовых замен «один в один» нет и переход потребует инженерного времени [3]. Незадолго до окончания поддержки, 2 февраля 2026 года, были раскрыты ещё четыре уязвимости высокой степени опасности [3]. После окончания поддержки появляются новые CVE в зависимостях и в самом NGINX, затрагивающие последние сборки контроллера; закрывают их только коммерческие поставщики расширенной поддержки [4].
Что это значит для бизнеса. Контроллер Ingress — это входная дверь для всего HTTP-трафика: сайта, личного кабинета, API мобильного приложения, вебхуков платёжных систем, обмена с учётными системами. Оставить его без исправлений безопасности — значит оставить без исправлений самый открытый наружу компонент инфраструктуры. При этом «быстрая замена» без проверки поведения способна сломать оплату или вход так же надёжно, как атака.
Чем это отличается от окончания поддержки ОС, языка или СУБД. Там обычно достаточно перейти на новую версию того же продукта и проверить совместимость. Здесь меняется сам компонент, который решает, куда отправить каждый запрос. У нового контроллера своя семантика маршрутов: как сравниваются пути и регулярные выражения, какие действуют лимиты и тайм-ауты, какие редиректы срабатывают без явной настройки. Поэтому миграция ingress-nginx — это проверка поведения маршрутов, а не обновление версии.
Ingress, контроллер и Gateway API: короткое объяснение
Ingress — стандартный объект Kubernetes, в котором описано: «запросы на такой-то домен и путь отправлять в такой-то сервис». Сам по себе он ничего не делает. Трафик обрабатывает Ingress-контроллер — отдельная программа в кластере, которая читает объекты Ingress и настраивает прокси [1].
Стандарт Ingress очень простой, поэтому всё, что сложнее «домен + путь», контроллеры добавляли через собственные аннотации, ConfigMap и CRD [5]. Отсюда главная сложность миграции: значительная часть логики ваших маршрутов живёт не в стандартных полях, а в аннотациях вида nginx.ingress.kubernetes.io/..., которые другой контроллер не понимает.
Gateway API — более новый стандарт Kubernetes, который проект рекомендует как замену Ingress [1]. В нём ответственность разделена: инфраструктурная команда описывает точку входа (Gateway), а команда приложения — маршруты (HTTPRoute). Многое из того, что раньше делалось аннотациями, — разделение трафика по весам, работа с заголовками, редиректы, переписывание путей, тайм-ауты — стало частью спецификации [6][7].

Важно не путать. Community ingress-nginx (kubernetes/ingress-nginx) и NGINX Ingress Controller от F5 — это два разных контроллера. Оба используют NGINX в качестве прокси, но в остальном не связаны [8]. Окончание поддержки относится только к первому. Сам веб-сервер NGINX и продукты F5 продолжают развиваться; у NGINX Ingress от F5 свои аннотации и собственное руководство по переходу [9].Шаг 1. Убедиться, что у вас именно community ingress-nginx
Начните с команды, которую рекомендует сам проект Kubernetes (нужны права администратора кластера) [1]:
kubectl get pods --all-namespaces \ --selector app.kubernetes.io/name=ingress-nginx
Метки могут отличаться, если контроллер ставили нестандартным способом или он пришёл в составе платформы провайдера. Поэтому дополнительно проверьте:
# Какие классы Ingress есть и какой контроллер их обслуживает
kubectl get ingressclass -o custom-columns=NAME:.metadata.name,CONTROLLER:.spec.controller
# Какие образы прокси реально запущены
kubectl get pods -A -o jsonpath='{range .items[*]}{.metadata.namespace}{"\t"}{.metadata.name}{"\t"}{.spec.containers[*].image}{"\n"}{end}' \
| grep -i -E 'ingress|nginx'
# Какие префиксы аннотаций используются в Ingress
kubectl get ingress -A -o json \
| jq -r '.items[].metadata.annotations // {} | keys[]' \
| cut -d/ -f1 | sort | uniq -c
Как интерпретировать:
- аннотации с префиксом
nginx.ingress.kubernetes.io/— признак community ingress-nginx; - аннотации
nginx.org/— признак NGINX Ingress Controller от F5; - образ из реестра
registry.k8s.io/ingress-nginx/...— community-контроллер.
Если кластер управляемый, уточните у провайдера, кто обновляет контроллер: вы или платформа. Встречаются три ситуации: контроллер установлен вами через Helm или Marketplace; контроллер входит в состав платформы и провайдер объявил свою политику; используется собственный контроллер провайдера, и ingress-nginx в кластере нет вовсе.
Шаг 2. Собрать карту маршрутов
Что выгрузить из кластера
Карта маршрутов — это таблица «домен → путь → сервис → особые правила», дополненная глобальными настройками. Соберите:
- Все объекты Ingress во всех пространствах имён, включая хосты, пути,
pathType, TLS-секреты и аннотации. Отдельно отметьте правила rewrite и редиректы (rewrite-target,app-root,permanent-redirect), ограничения запросов и списки IP (limit-rps,limit-connections,whitelist-source-range) и настройки TLS (ssl-redirect,ssl-passthrough,auth-tls-*,backend-protocol) [2]. - ConfigMap контроллера. Здесь задаются глобальные значения: максимальный размер тела запроса, тайм-ауты, HSTS, редирект на HTTPS, доверенные адреса балансировщика, глобальная внешняя авторизация [10]. Значения из ConfigMap действуют на все маршруты, даже если в Ingress ничего не указано.
- Параметры запуска контроллера и values Helm-чарта — например, включён ли SSL passthrough (он работает только с отдельным флагом запуска) [2].
- ConfigMap для TCP/UDP-сервисов, если через контроллер публикуются не-HTTP порты.
- Сервис типа LoadBalancer перед контроллером: внешний IP,
externalTrafficPolicy, аннотации облачного балансировщика. - Внешние зависимости: DNS-записи, CDN, WAF, белые списки IP у партнёров.
Пример выгрузки аннотаций в табличный вид:
kubectl get ingress -A -o json | jq -r '
.items[] as $i
| ($i.metadata.annotations // {}) | to_entries[]
| select(.key | startswith("nginx.ingress.kubernetes.io/"))
| [$i.metadata.namespace, $i.metadata.name,
($i.spec.rules // [] | map(.host) | join(",")),
(.key | sub("nginx.ingress.kubernetes.io/";"")), .value] | @tsv' \
> ingress-annotations.tsv
kubectl get configmap -A -l app.kubernetes.io/name=ingress-nginx -o yaml \
> ingress-nginx-configmaps.yaml
Дальше сгруппируйте аннотации по смыслу: маршрутизация и rewrite; редиректы; авторизация; лимиты и списки IP; тайм-ауты и буферы; CORS и заголовки; canary и привязка сессий; сниппеты. Для каждой группы нужно решение: перенести штатно, перенести через расширение выбранной реализации, переделать в приложении или осознанно отказаться.
Группируйте по хостам, а не по объектам Ingress. Как показано ниже, аннотация в одном Ingress может менять поведение соседних Ingress с тем же доменом [8][2].
Скрытые поведения, которые не видны в YAML
Блог Kubernetes перед окончанием поддержки отдельно разобрал поведения ingress-nginx, которые ломают «правильную на вид» миграцию [8]. Коротко:
- Регулярные выражения работают как префиксные и без учёта регистра. Шаблон
/[A-Z]{3}в ingress-nginx пропустит запрос/uuid. Популярные реализации Gateway API на Envoy (Istio, Envoy Gateway, kgateway) сравнивают выражение целиком и с учётом регистра, поэтому тот же шаблон вHTTPRouteперестанет совпадать [8]. use-regexдействует на весь хост. Если хотя бы один Ingress для домена включил регулярные выражения, регистронезависимый regex-режим применяется ко всем путям этого домена во всех Ingress [2]. Путь с опечаткой в соседнем объекте мог годами «работать», а после миграции начнёт отдавать 404 [8].rewrite-targetнеявно включает тот же режим — с теми же последствиями для всего хоста [8][2].- Автоматический 301 на адрес со слешем. Если путь объявлен как
/my-path/, запрос на/my-pathполучает постоянный редирект. В Gateway API такого неявного поведения нет, и его нужно описать явным правилом, если на него полагаются клиенты [11]. - Нормализация URL. ingress-nginx убирает сегменты
.и..и схлопывает повторные слеши до сопоставления с правилами. Реализации на Envoy в целом делают похожее, но детали различаются, поэтому проверять нужно на своём трафике [11].
Практический вывод: часть поведения, на которое опираются клиенты, не записана ни в одном манифесте. Её можно найти только по журналам доступа (например, доля 301 и 404 по путям) и тестами.

Шаг 3. Проверить чувствительные сценарии
Ниже — области, где расхождение между старым и новым контроллером обычно проявляется не сразу и бьёт по пользователям.
Авторизация
В ingress-nginx встречаются три механизма [2]:
- базовая HTTP-авторизация (
auth-type,auth-secret) — часто закрывает админки, staging, служебные панели; - внешняя авторизация (
auth-url,auth-signin,auth-response-headers), когда каждый запрос сначала проверяется отдельным сервисом — типичный вариант для oauth2-proxy и SSO; - проверка клиентских сертификатов (
auth-tls-*, mTLS) для B2B-интеграций.
Отдельно проверьте глобальную авторизацию: если в ConfigMap задан global-auth-url, она применяется ко всем Ingress, кроме явно исключённых [2][10].
В Gateway API внешняя авторизация реализуется расширениями конкретной реализации, а не одним стандартным полем, и именно этот блок разборы относят к требующим ручной работы [11]. У облачных реализаций может быть свой механизм: например, в таблице соответствия Yandex Cloud аутентификация переносится на RBAC-правила балансировщика [12].
Что проверить: запрос без учётных данных отклоняется тем же кодом; после входа приложение получает те же заголовки с данными пользователя; редирект на страницу входа сохраняет исходный адрес; служебные пути исключены из авторизации так же, как раньше.
WebSocket и долгие соединения
Чаты, уведомления, live-обновления и некоторые админки держат соединение открытым. В ingress-nginx тайм-ауты чтения и отправки к бэкенду по умолчанию равны 60 секундам [10], поэтому команды часто поднимали их аннотациями proxy-read-timeout и proxy-send-timeout [2]. Если в новой реализации значения окажутся другими, соединения начнут обрываться через предсказуемый интервал — и это легко принять за ошибку приложения.
В Gateway API протокол бэкенда и поддержка WebSocket развивались отдельно; в версии 1.2 эта тема вошла в стабильный канал вместе с тайм-аутами [7]. Конкретные настройки простоя соединения обычно задаются политиками выбранной реализации.
Что проверить: соединение устанавливается; живёт дольше прежнего тайм-аута без сообщений; корректно переподключается после перезапуска пода контроллера.
Загрузка больших файлов
Глобальный лимит размера тела запроса у ingress-nginx по умолчанию — 1 МБ; при превышении клиент получает 413 [2][10]. Почти в каждом проекте с загрузкой документов, фото или выгрузок этот лимит где-то увеличен — в ConfigMap или аннотацией proxy-body-size. Также важны буферизация (proxy-request-buffering, client-body-buffer-size) и тайм-аут получения тела от клиента [2][10].
Что проверить: загрузку файла чуть меньше и чуть больше прежнего лимита; загрузку по медленному каналу; поведение при обрыве; одинаковый ли код ошибки получает фронтенд.
Тайм-ауты
Значения ingress-nginx по умолчанию: подключение к бэкенду — 5 секунд, чтение и отправка — по 60 секунд, до трёх повторных попыток на следующий под при ошибке или тайм-ауте [10]. Неидемпотентные запросы (POST, PATCH) по умолчанию повторно не отправляются [10].
В Gateway API у правила HTTPRoute есть два тайм-аута: на весь запрос и на отдельное обращение к бэкенду [6]; в стандартный канал они вошли в версии 1.2 [7]. Если тайм-аут не задан, поведение определяет реализация [6] — то есть «по умолчанию» у разных продуктов разное.
Что проверить: длинные отчёты и экспорт; обмен с учётными системами; медленные ответы внешних API, проксируемые через ваш бэкенд; отсутствие повторной отправки платёжных и создающих запросов.
IP-адрес клиента и ограничения запросов
Реальный IP посетителя нужен для журналов, антифрода, ограничений по IP, белых списков и расследования инцидентов. Он может потеряться на двух уровнях:
- Сервис-балансировщик. При
externalTrafficPolicy: Cluster(значение по умолчанию) исходный IP клиента скрывается, а приLocalсохраняется ценой возможной неравномерности нагрузки [13]. - Доверие заголовкам. ingress-nginx по умолчанию не доверяет
X-Forwarded-For(use-forwarded-headers: false); если перед кластером стоит балансировщик или CDN, это включают вместе с PROXY protocol и списком доверенных адресов [2][10]. Обратите внимание: по умолчанию список доверенных сетей —0.0.0.0/0[10]. Если заголовкам доверяют без ограничения источника, клиент может подменить свой IP. При миграции это стоит исправить, а не перенести.
Ограничения запросов (limit-rps, limit-connections) в ingress-nginx считаются на каждую реплику контроллера: при трёх репликах фактический лимит примерно втрое выше, а при автомасштабировании он «плавает». Превышение по умолчанию возвращает 503, а не 429 [2]. В новой реализации лимит может считаться глобально и отвечать другим кодом — проверьте, как на это реагируют клиенты и мониторинг. Аналогично переносятся whitelist-source-range и denylist-source-range [2].
TLS и редиректы
Значения ingress-nginx по умолчанию: при наличии TLS — редирект на HTTPS с кодом 308; HSTS включён с max-age в один год и поддоменами; протоколы TLS 1.2 и 1.3 [2][10]. Новая реализация может иметь другие настройки, и тогда изменятся заголовки безопасности или код редиректа. Если используется SSL passthrough, учитывайте, что при нём остальные аннотации ingress-nginx на объект не действуют [2].
Что проверить: HTTP→HTTPS, коды и Location; заголовок HSTS; цепочку сертификата и SNI для всех доменов; выпуск и продление сертификатов (cert-manager и ACME-проверки по /.well-known/acme-challenge — ingress-nginx по умолчанию исключает этот путь из редиректа и авторизации [10]); старые клиенты и интеграции, которые могут не поддерживать новые наборы шифров.
Шаг 4. Выбрать замену по сценариям, а не по успешному применению YAML
Варианты
- Gateway API на одной из реализаций — рекомендуемое направление проекта Kubernetes [1]. Реализаций много: на Envoy, на NGINX, встроенные в CNI, облачные. Выбирать стоит по отчётам о соответствии спецификации (conformance), знакомой команде технологии прокси и интеграции с платформой [14].
- Другой Ingress-контроллер. Допустимо, если нужно быстро уйти с неподдерживаемого компонента [1]. Минус — вы остаётесь на Ingress API с аннотациями другого вендора, и следующая миграция всё равно предстоит.
- Временное продление через коммерческую расширенную поддержку ingress-nginx. Снижает риск по уязвимостям, пока идёт миграция, но не заменяет её [4].
Матрица оценки
Сведите в таблицу сценарии из шагов 2–3 и для каждого кандидата отметьте: поддерживается стандартным API / через расширение реализации / только в приложении / не поддерживается.

- Маршрутизация хост+путь, regex — что требуется: совпадение тех же URL, что и раньше; как проверить: прогон списка реальных путей из журналов.
- Rewrite и редиректы — что требуется: те же целевые адреса и коды; как проверить: сравнение
Locationи статусов. - Внешняя авторизация, basic, mTLS — что требуется: тот же отказ и те же заголовки после входа; как проверить: запросы с ролями и без.
- WebSocket, SSE, gRPC — что требуется: длительность соединения не меньше прежней; как проверить: тест с простоем дольше старого тайм-аута.
- Загрузка файлов — что требуется: лимит не меньше прежнего; как проверить: файлы на границе лимита.
- Тайм-ауты и повторы — что требуется: нет обрывов отчётов, нет повторов POST; как проверить: медленный тестовый эндпоинт.
- IP клиента — что требуется: корректный IP в журналах приложения; как проверить: запрос с известного адреса, попытка подмены XFF.
- Лимиты и списки IP — что требуется: сопоставимый порог и понятный код ответа; как проверить: нагрузочный тест на тестовом хосте.
- TLS, HSTS, сертификаты — что требуется: те же протоколы, заголовки, автопродление; как проверить: проверка внешними TLS-сканерами.
- Canary, привязка сессий — что требуется: тот же процент и та же «липкость»; как проверить: серия запросов с cookie и без.
- Наблюдаемость — что требуется: метрики по кодам и задержкам на маршрут; как проверить: дашборд до переключения.
- Эксплуатация — что требуется: обновления, команда, поддержка; как проверить: политика релизов и CVE у вендора.
В спецификации Gateway API фильтры делятся на базовые (обязательные для всех реализаций), расширенные (желательные) и специфичные для реализации — без гарантий переносимости [6]. Разделение трафика по весам и зеркалирование (RequestMirror) описаны в самом API [6], а вот внешняя авторизация, rate limiting и canary по cookie обычно требуют расширений [11].
Что делает и чего не делает ingress2gateway
ingress2gateway — официальный инструмент SIG Network для перевода Ingress в ресурсы Gateway API. В версии 1.0 он поддерживает более 30 распространённых аннотаций ingress-nginx (CORS, TLS к бэкенду, regex, rewrite и другие), а каждое поддерживаемое преобразование покрыто интеграционными тестами, которые сравнивают поведение живых контроллеров, а не только структуру YAML [5]. Инструмент читает ресурсы из кластера или файлов, умеет выдавать стандартные ресурсы или дополнительные объекты под конкретную реализацию (Envoy Gateway, kgateway, GKE и другие) и предупреждает о непереведённых полях [15].
# Только печать результата — ничего не применяется к кластеру ingress2gateway print --providers=ingress-nginx -A > gateway-draft.yaml # Если IngressClass называется не "nginx", укажите его явно ingress2gateway print --providers=ingress-nginx -A \ --ingress-nginx-ingress-class=<имя-класса> > gateway-draft.yaml
Учтите две детали. По умолчанию провайдер ingress-nginx выбирает класс с именем nginx [15] — при другом имени класса инструмент «не увидит» ваши объекты. И сам проект называет его ассистентом миграции, а не разовой заменой: его задача — перенести поддерживаемое, подсветить неподдерживаемое и дать повод пересмотреть нежелательные настройки [5]. Неявное поведение вроде автоматического 301 на слеш переносить просто не из чего, а сниппеты по определению требуют ручного решения [11].
Российские провайдеры описывают похожий подход: в документации Selectel ingress2gateway используется для черновой конвертации при переходе на Envoy Gateway, а недостающие объекты (например, GatewayClass) добавляются вручную [16]. Yandex Cloud для перехода на свой контроллер Gwin публикует таблицу соответствия аннотаций ingress-nginx [12].
Шаг 5. Тестовый трафик, сравнение и поэтапное переключение
- Параллельная установка. Новый контроллер разворачивается рядом со старым, со своим классом и своим внешним IP. Документация Gateway API прямо рекомендует такой режим [14]. Старые объекты Ingress не трогаем.
- Тестовые хосты. Для каждого домена создаётся тестовое имя (например,
new.shop.example) или используется подмена в/etc/hosts/curl --resolve. На этом этапе проверяются сценарии из шага 3. - Сравнение на реальных путях. Из журналов доступа берутся самые частые и самые важные пути, они прогоняются через оба контроллера, сравниваются статусы, заголовки
Location, размеры ответов и задержки. Особое внимание — сдвигам вида «200 → 301» и «200 → 404»: это характерный признак неявных поведений ingress-nginx [11]. - Зеркалирование (по возможности). Копию части боевого трафика можно направлять на новый путь, не влияя на ответы клиентам: в Gateway API для этого есть фильтр
RequestMirror[6], в ingress-nginx — аннотацияmirror-target[2]. Не зеркалируйте запросы с побочными эффектами (создание заказа, оплата), если бэкенд-копия может их выполнить. - Подготовка DNS. Заранее уменьшите TTL записей, чтобы переключение и откат занимали минуты, а не часы.
- Переключение по одному домену. Начинайте с наименее критичного: внутренние панели, статика, затем API, затем витрина и оформление заказа. Yandex Cloud описывает такую же последовательность: создать новые ресурсы без удаления старых, проверить маршрутизацию, проверки бэкендов, журналы и метрики, затем переключить DNS и наблюдать за метриками [12].
- Наблюдение после каждого шага. Сравнивайте долю 4xx/5xx, задержки p95/p99, число 413, 499/504, обрывы WebSocket, ошибки входа — по маршрутам, а не в среднем по сайту.
Совет: на время миграции заморозьте изменения в Ingress или договоритесь, что каждое изменение вносится сразу в обе конфигурации. Иначе к моменту отката старая конфигурация окажется устаревшей.
Шаг 6. Откат и подтверждение бизнес-операций
План отката готовится до переключения:
- старый контроллер и его внешний IP остаются в работе до конца периода наблюдения (обычно не меньше одного полного бизнес-цикла: неделя с выходными, закрытие месяца, акция);
- откат — это возврат DNS-записи (или веса в балансировщике) на старый IP; команда и ответственный определены заранее;
- критерии отката записаны числами: например, рост 5xx на маршруте оформления заказа выше согласованного порога или любая ошибка платёжных уведомлений;
- сертификаты действительны на обоих контроллерах, чтобы откат не превратился в инцидент TLS.
Контрольные бизнес-операции — короткий список действий, по которым руководство и поддержка понимают, что «всё работает». Для интернет-магазина и SaaS это обычно:
- Регистрация и вход, в том числе через SSO — авторизация, cookie, редиректы
- Поиск, каталог, карточка товара — маршрутизация, rewrite, кеш-заголовки
- Корзина и оформление заказа до тестовой оплаты — сессии, тайм-ауты, привязка к бэкенду
- Приём уведомления от платёжного сервиса — доступность callback-адреса, IP-ограничения
- Загрузка документа или фото — лимит тела запроса, буферизация
- Чат, уведомления, live-обновления — webSocket, тайм-ауты простоя
- Обмен с учётной системой, выгрузка отчёта — длинные запросы, большие ответы
- Вызовы API мобильного приложения и партнёров — версии TLS, заголовки, CORS, лимиты
- Действия в админке под разными ролями — basic/внешняя авторизация, списки IP
Эти операции стоит автоматизировать как синтетические проверки и запускать до переключения, сразу после и регулярно в период наблюдения. Тогда решение «оставляем или откатываем» принимается по фактам.

Российская специфика
- Управляемый Kubernetes у российских провайдеров. Провайдеры уже публикуют собственные пути: Selectel — инструкцию по переходу на Gateway API с Envoy Gateway и пример переноса rate limiting и CORS в политики Envoy Gateway [16]; Yandex Cloud — контроллер Gwin и таблицу соответствия аннотаций ingress-nginx, включая редиректы, rewrite, тайм-ауты, ограничение скорости и привязку сессий [12]. Перед выбором уточните у провайдера, кто отвечает за обновления контроллера и какие функции поддерживает его реализация.
- Новый внешний IP. При параллельной установке у нового контроллера будет другой адрес. Проверьте, не привязаны ли к старому IP белые списки у банков, платёжных сервисов, маркетплейсов, госсистем и партнёров по обмену, а также правила на межсетевых экранах и в CDN.
- Обмен с учётными системами. Обмен с 1С и ERP по HTTP часто означает большие пакеты и долгие запросы. Это первые кандидаты на ошибки 413 и 504 после смены контроллера — включите их в контрольные операции.
- Требования информационной безопасности. Если система обрабатывает персональные данные, является государственной информационной системой или объектом КИИ, использование компонента, для которого больше не выпускаются исправления уязвимостей, стоит отдельно согласовать со службой ИБ и отразить в плане устранения уязвимостей. Конкретные обязательства зависят от класса системы и применимых требований, поэтому их нужно проверять для вашего случая.
- Журналы и IP. Если IP клиента используется в журналах для расследований или антифрода, его корректность — часть приёмки, а не «желательная» проверка.
Частые ошибки и риски
- Считать миграцию завершённой, когда YAML применился. Применение манифеста подтверждает синтаксис, а не поведение [5][11].
- Перепутать контроллеры и мигрировать с F5 NGINX Ingress, который не затронут, или наоборот пропустить community ingress-nginx в составе платформы [8].
- Забыть про ConfigMap. Глобальные лимиты, тайм-ауты и авторизация не видны в объектах Ingress [10].
- Пропустить неявные поведения: регулярные выражения, влияние аннотаций на весь хост, 301 на слеш [8][11].
- Перенести небезопасное «как было»: сниппеты, неограниченное доверие
X-Forwarded-For[1][10]. - Удалить старый контроллер в день переключения — и лишиться быстрого отката.
- Не учесть лимиты на реплику и получить другое фактическое ограничение запросов и другой код ответа [2].
- Проверять только главную страницу, а не оплату, загрузку файлов и интеграции.
Практический результат: карта маршрутов и программа миграции
По итогам подготовки у команды должно быть два документа.
Карта маршрутов (таблица; одна строка — один хост и путь):
- Домен, путь, тип совпадения —
shop.example,/api/, Prefix / regex - Сервис и порт —
api:8080 - Аннотации и глобальные настройки — rewrite,
proxy-body-size: 50m, auth-url - Неявные поведения — regex-режим хоста, 301 на слеш
- Решение — стандартный API / расширение / приложение / отказ
- Владелец — команда или ответственный
- Контрольная операция — «загрузка договора в кабинете»
- Критерий приёмки и отката — «413 = 0, 5xx < порога»
Программа миграции: этапы (инвентаризация → выбор реализации → тестовый стенд → параллельный запуск → поэтапное переключение доменов → период наблюдения → вывод старого контроллера), для каждого — ответственный, критерии перехода дальше, план отката и список контрольных бизнес-операций.
Вывод
Окончание поддержки ingress-nginx — не авария, а уже наступивший срок: всё продолжает работать, но самый открытый наружу компонент больше не получает исправлений. Безопасный переход строится не вокруг выбора «лучшего контроллера», а вокруг знания собственной конфигурации: карты маршрутов, глобальных настроек, неявного поведения и списка бизнес-операций, которые должны работать после переключения. Параллельный запуск, переключение по доменам и заранее подготовленный откат превращают миграцию из рискованного события в управляемый процесс.
Источники
[1] kubernetes.io — Ingress NGINX Retirement: What You Need to Know — https://kubernetes.io/blog/2025/11/11/ingress-nginx-retirement/
[2] kubernetes.github.io — Ingress-Nginx Controller: Annotations — https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/
[3] securitylabs.datadoghq.com — Kubernetes project issues warning on Ingress NGINX retirement — https://securitylabs.datadoghq.com/articles/kubernetes-ingress-nginx-retirement-warning/
[4] herodevs.com — Ingress NGINX End of Life (March 2026): Risks, Migration Paths, and Support Options — https://www.herodevs.com/blog-posts/ingress-nginx-end-of-life-2026-migration-and-support
[5] kubernetes.io — Announcing Ingress2Gateway 1.0: Your Path to Gateway API — https://kubernetes.io/blog/2026/03/20/ingress2gateway-1-0-release/
[6] gateway-api.sigs.k8s.io — HTTPRoute — https://gateway-api.sigs.k8s.io/api-types/httproute/
[7] kubernetes.io — Gateway API v1.2: WebSockets, Timeouts, Retries, and More — https://kubernetes.io/blog/2024/11/21/gateway-api-v1-2/
[8] kubernetes.io — Before You Migrate: Five Surprising Ingress-NGINX Behaviors You Need to Know — https://kubernetes.io/blog/2026/02/27/ingress-nginx-before-you-migrate/
[9] devclass.com — Kubernetes leadership warns of Ingress NGINX risks, but has also hastened its deprecation — https://devclass.com/2026/01/29/kubernetes-leadership-warns-of-ingress-nginx-risks-but-has-also-hastened-its-deprecation/
[10] kubernetes.github.io — Ingress-Nginx Controller: ConfigMap — https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/
[11] bex.co — Five Surprising Ingress-NGINX Behaviors to Audit Before Migrating to Gateway API — https://bex.co/blog/2026/09/25/ingress-nginx-gateway-api-migration-audit
[12] yandex.cloud — Миграция приложений с Ingress NGINX на Gwin — https://yandex.cloud/ru/docs/managed-kubernetes/alb-ref/nginx-gwin-migration
[13] kubernetes.io — Create an External Load Balancer — https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/
[14] gateway-api.sigs.k8s.io — A Welcome Guide for Ingress-NGINX Users — https://gateway-api.sigs.k8s.io/guides/getting-started/migrating-from-ingress-nginx/
[15] github.com — kubernetes-sigs/ingress2gateway — https://github.com/kubernetes-sigs/ingress2gateway
[16] docs.selectel.ru — Миграция с Ingress на Gateway API — https://docs.selectel.ru/managed-kubernetes/networks/migrate-ingress-to-gateway-api/
Быстрые вопросы и ответы
Ingress-nginx перестанет работать после окончания поддержки?
Нет. Существующие установки продолжают обрабатывать трафик, а образы и Helm-чарты остаются доступными. Риск в другом: для community-проекта больше не выходят новые исправления ошибок и уязвимостей.
Нужно ли всем переходить именно на Gateway API?
Не обязательно. Kubernetes рекомендует рассмотреть Gateway API, но допускает и другие поддерживаемые Ingress-контроллеры. Выбирайте реализацию по вашим маршрутам, политике провайдера и результатам тестирования, а не по названию стандарта.
Может ли ingress2gateway автоматически завершить миграцию?
Нет. Он помогает получить черновые ресурсы Gateway API из существующих Ingress и поддерживает ряд аннотаций, но скрытые правила, различия реализаций, внешнюю авторизацию и реальные бизнес-операции нужно проверять отдельно.
Что проверить до переключения продакшен-трафика?
Минимум — вход и авторизацию, оплату и вебхуки, редиректы, загрузку файлов, WebSocket или другие долгие соединения, IP клиента, TLS и сертификаты. Сравните ответы старого и нового пути на одном наборе запросов.
Как уменьшить риск простоя?
Запустите новый путь параллельно, проверьте контрольные операции, переключайте трафик поэтапно и наблюдайте за ошибками. Заранее зафиксируйте критерии отката и сохраните работоспособную прежнюю конфигурацию на период наблюдения.