🌐 Как запрос доходит до приложения
User Service работает в трёх Pod, но клиенту нужен один адрес для запроса /users. После обновления Pod получат другие имена и адреса. В этой странице соберёшь путь запроса, чтобы отличать ошибку маршрутизации от поломки приложения и понимать, что проверяет port-forward
🌐 Один адрес для сменяющихся Pod
Другой сервис обращается к имени user-service, а не запоминает адрес каждого экземпляра. За таким постоянным именем стоит Service. В обычном случае он выбирает Pod по меткам, а Kubernetes обновляет сведения об адресатах по мере появления и исчезновения экземпляров
Например, у Pod User Service стоит метка app=user-service. Service с таким selector направляет запросы к подходящим Pod. Сам Deployment не становится сетевым адресом: он поддерживает приложение, а Service задаёт способ обращения к нему
В тренажёре selector ошибочно указывает на Notification Service. Запрос /users доходит до работающего HTTP-сервера, но тот не знает такой маршрут и отвечает 404. Исправлять число реплик бессмысленно: нужно сопоставить selector Service с метками нужных Pod, затем повторить тот же запрос
Для проверки в собственном учебном кластере:
kubectl -n staging get service user-service -o yaml
kubectl -n staging get pods --show-labels
kubectl -n staging get endpointslices -l kubernetes.io/service-name=user-serviceEndpointSlice хранит сведения об адресатах Service, включая их готовность. Если подходящих готовых Pod нет, постоянное имя Service само по себе не спасёт запрос. Неверный selector и провал readiness могут выглядеть для клиента похоже, но причины у них разные
🔌 Какие порты сравнить
Предположим, приложение слушает 3000, а Service доступен на 80. У Service port: 80 обозначает входной порт, а targetPort: 3000 указывает порт приложения. Они могут отличаться. Поле containerPort в описании контейнера документирует порт; оно не заставляет программу начать его слушать
Для внутреннего доступа обычно используют тип Service ClusterIP. Тип LoadBalancer запрашивает внешний балансировщик у поддерживающей его инфраструктуры. NodePort открывает порт на узлах для доступа к Service. Выбор типа зависит от устройства кластера; создание ClusterIP не публикует API в интернете
🚪 Как браузер находит приложение
Пользователь открывает адрес сайта и вызывает /users. На внешнем входе нужно выбрать сервис по домену и пути, а при HTTPS ещё обработать TLS. Правила такого выбора можно описать объектом Ingress
Правила должен кто-то выполнять. Ingress Controller следит за объектами Ingress и настраивает балансировщик или прокси. Если создать только Ingress без подходящего контроллера, работающий вход не появится
Клиент → внешний адрес / балансировщик
→ прокси, настроенный Ingress Controller
→ адресаты Service user-service → готовый PodЭто логическая схема. Конкретный контроллер может обращаться прямо к адресам Pod из EndpointSlice, не пропуская каждый пакет через виртуальный IP Service. Для диагностики всё равно сравнивают правило входа, Service и его адресатов
Когда внутренний запрос работает, а внешний нет, проверь домен, TLS, правило пути и выбранный контроллер. Когда через внешний адрес приходит 404, сначала выясни, кто его вернул: входной прокси или приложение. Один код ответа ещё не называет сломанный компонент
🧭 Где встречается Gateway API
В кластере вместо Ingress можно увидеть Gateway API. Он разделяет описание общей точки входа и маршрутов приложений: Gateway задаёт вход, а HTTPRoute связывает HTTP-запрос с Service. GatewayClass определяет класс реализации
Этот API используют при построении новых входных маршрутов и миграции существующих. Для работы нужны установленные расширения API и совместимый контроллер. Наличие Kubernetes само по себе не гарантирует, что команда уже выбрала Gateway API
Ingress API сохранён, но его развитие заморожено; проект Kubernetes рекомендует Gateway API для новых возможностей. Отдельный проект ingress-nginx завершил поддержку. Это не означает удаления самого Ingress API и не относится автоматически ко всем продуктам с NGINX в названии. Перед выбором контроллера проверь поддержку конкретной реализации
🛠️ Port-forward обходит часть маршрута
Чтобы открыть приложение локально, не создавая внешний вход, можно временно перенаправить порт к одному Pod. В своём учебном кластере подставь имя Pod вместо POD_NAME:
kubectl -n staging port-forward pod/POD_NAME 18080:3000Пока команда работает, запрос к http://localhost:18080/users попадёт на порт 3000 выбранного Pod. Локальный порт 18080 должен быть свободен. Для остановки используй Ctrl+C; при завершении выбранного Pod туннель нужно открыть заново
Успех через port-forward проверяет отдельный путь к Pod. Он не доказывает исправность Ingress, selector Service или внешнего TLS. Даже запись port-forward service/... выбирает Pod, а не воспроизводит полный внешний маршрут. В тренажёре такой туннель моделируется в браузере, реальный порт на компьютере не открывается
🎯 Вопросы с собеседований
Чем Ingress отличается от Ingress Controller?
Ingress описывает правила для домена и пути. Контроллер читает их и настраивает работающий сетевой вход. Поэтому я проверю и сам объект, и то, какой контроллер его обслуживает
Через port-forward работает, а через сайт нет. Что это говорит?
Выбранный экземпляр приложения отвечает по проверенному порту. Дальше я проверю Service, selector и готовые адресаты, затем внешний маршрут и TLS. Port-forward обходит эти части пути, поэтому такой успех помогает сузить поиск, но не закрывает проверку релиза
📚 Что почитать
- Service — адреса, типы и выбор Pod
- Ingress и Gateway API — правила внешнего входа
- Завершение поддержки ingress-nginx — границы изменения
- kubectl port-forward — временный доступ к Pod
К началу раздела Kubernetes · Дальше: От коммита до работающего релиза