Provision
—— XP

Ingress: вход снаружи

теория~8 минут+250 XP

Сервис типа ClusterIP виден только внутри кластера, а port-forward — туннель для одного человека, а не вход для пользователей. Чтобы сайт открывался снаружи по имени, кто-то должен принимать запросы на общем порту и решать, какому сервису их отдать. В Compose эту роль играл nginx перед приложением, и его конфиг ты писал руками. В кластере для этого есть отдельный объект.

Ingress — объект Kubernetes с правилами вида «запросы на такое-то имя и такой-то путь отдавать такому-то сервису». Ingress-контроллер — программа внутри кластера, которая эти правила читает и сама принимает трафик снаружи, как nginx из раздела 05. Правила без контроллера — как список кабинетов на стойке вахтёра, за которой никого нет: читать его некому. Слово ingress ты уже встречал в уроке про входящий и исходящий трафик, но там оно значило любое входящее соединение и правило файрвола для него, а объект Ingress — только вход HTTP по имени сайта.

Вместе они дают один вход на все сервисы, разбор по имени и пути и HTTPS в одном месте. Правила — обычные объекты, и контроллер подхватывает их сам.

Путь запроса снаружи

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

Путь запроса сверху вниз: клиент, внешний балансировщик или NodePort, контроллер Ingress с завершением TLS, сервис и наконец под.
Объект Ingress ничего не выполняет — это правила для контроллера. Читает их работающий рядом под, и без него правила мертвы.

Снаружи запрос приходит на балансировщик: в облаке это сервис типа LoadBalancer, у k3d — тот контейнер serverlb, которому в практике ты пробросишь порт 8090. Дальше его берёт контроллер, сверяет со списком правил и отдаёт нужному сервису. Сервис выбирает готовый под.

В k3s контроллер уже стоит из коробки — это Traefik, ты видел его среди системных подов. В других кластерах его ставят отдельно. Долго самым популярным был ingress-nginx, но в 2026 году проект снят с поддержки, и в новых статьях ты чаще встретишь Traefik, другие контроллеры или Gateway API — новый стандарт с той же идеей.

Правило и контроллер — разные вещи

Это различие — главный источник путаницы, поэтому стоит увидеть его отдельно.

Слева браузер, дальше контроллер Ingress, который читает правило с указанием имени, пути и сервиса. Справа сервис и два пода. Пунктирная стрелка показывает, что контроллер читает правило, а не является им.
Правило — запись в базе кластера. Если контроллера нет, kubectl apply пройдёт без ошибок, а запросы упрутся в пустоту.

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

ubuntu@stand:~$
kubectl get ingressclass
ubuntu@stand:~$
NAME      CONTROLLER                      PARAMETERS   AGE
traefik   traefik.io/ingress-controller   <none>       2h

Строка есть — контроллер установлен, и его имя traefik потом пишут в правило. Пустой вывод — правила писать бесполезно.

Правило по частям

Описание Ingress читается тремя кусками. Первый — какой контроллер его обслуживает.

41-ingress.yaml, начало
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: provision
  namespace: provision
spec:
  ingressClassName: traefik

Второй — по какому имени сайта ловить запросы. Поле host сверяется с заголовком Host, который браузер посылает в каждом запросе.

продолжение spec
  rules:
    - host: stand.provision.internal
      http:
        paths:
          - path: /api
            pathType: Prefix

pathType: Prefix значит «всё, что начинается с /api»: подойдут /api/whoami и /api/items, а /apifoo — нет, совпадение идёт по частям пути между косыми.

Третий — кому отдать запрос.

продолжение пути
            backend:
              service:
                name: provision-app
                port:
                  number: 80

Правило указывает на сервис, а не на поды: балансировку делает сервис, как ты видел в практике. Имя сервиса и порт должны совпадать с теми, что в 31-service.yaml.

Срезать /api

Снаружи запросы приходят на /api/whoami, а приложение отвечает на /whoami. В разделе 08 nginx срезал префикс сам: proxy_pass со слешем в конце. Стандарт Ingress так не умеет — всё, кроме имени, пути и сервиса, у каждого контроллера своё.

У Traefik для этого есть отдельный объект — Middleware, промежуточный обработчик запроса.

Откуда у Kubernetes взялся чужой тип объекта? Список типов в кластере можно расширять: программа приносит с собой описание нового вида объектов — CRD (CustomResourceDefinition, «определение своего ресурса»), и после этого API-сервер принимает такие объекты так же, как Pod или Service. Traefik в k3s ставит свои CRD первой разовой задачей, helm-install-traefik-crd, которую ты видел в практике про кластер. Пока она не отработала, кластер слова Middleware не знает и ответит no matches for kind "Middleware". Список всех CRD показывает kubectl get crd.

40-middleware.yaml
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: strip-api
  namespace: provision
spec:
  stripPrefix:
    prefixes: ["/api"]

К правилу он подключается аннотацией — строкой в metadata.annotations, которую читает не Kubernetes, а сам контроллер: traefik.ingress.kubernetes.io/router.middlewares: provision-strip-api@kubernetescrd. Имя собирается из пространства, имени объекта и хвоста @kubernetescrd — так Traefik понимает, что объект надо искать среди своих CRD в Kubernetes, а не в файле настроек. Отсюда практический вывод: правило с аннотациями привязано к своему контроллеру, и смена контроллера означает переписывание таких правил.

HTTPS тоже завершается на контроллере: в правило добавляют блок tls со ссылкой на секрет с сертификатом, а сам сертификат в кластерах выпускает и продлевает cert-manager — программа, которая делает для Let's Encrypt то же, что certbot из раздела 05. На локальном стенде мы обходимся без него.

Что значит код ответа

Когда вход не работает, код ответа сразу говорит, на каком слое искать. Это стоит запомнить таблицей.

Что видишьЧто это значитКуда смотреть
Соединение не устанавливаетсяДо контроллера трафик не дошёлkubectl get ingressclass, проброшен ли порт
404 page not foundНи одно правило не подошло: имя, путь или классkubectl describe ingress
503 Service UnavailableПравило подошло, но у сервиса нет готовых подов; Traefik в такой ситуации иногда отвечает 404kubectl get endpoints
502 Bad GatewayПод есть, но не отвечает или отвечает мусоромkubectl logs пода

Разбери для примера вторую строку. Правило ждёт stand.provision.internal, а ты стучишься на localhost:8090 — заголовок Host другой, правило не подошло, Traefik отвечает своей страницей 404. Приложение здесь ни при чём, и в его логах этого запроса не будет вовсе.

Словарь урока

Ingress
Объект с правилами: какое имя и путь отдать какому сервису. Сам ничего не выполняет. ↩ к тексту
Ingress-контроллер
Программа в кластере, которая читает правила Ingress и принимает трафик. В k3s это Traefik. ↩ к тексту
ingressClassName
Какой контроллер обслуживает правило.
CRD
CustomResourceDefinition: описание нового вида объектов, которое программа добавляет в кластер. Пока его нет, такие объекты не принимаются. ↩ к тексту
Аннотация
Строка в metadata.annotations для конкретной программы. У каждого контроллера свои. ↩ к тексту
cert-manager
Оператор, который выпускает и продлевает сертификаты для Ingress. ↩ к тексту
Доступ снаружи
подборка на ютубе · ролик не закреплён
Ищи разборы, где показывают логи контроллера при неудачном запросе: по ним механизм становится понятен быстрее всего.

Что спросят на собеседовании

  • Чем Ingress отличается от Service типа LoadBalancer?
    LoadBalancer даёт один внешний адрес на один сервис и не разбирает HTTP. Ingress — один вход на много сервисов с разбором по имени и пути и завершением TLS.
  • Ingress создан, ничего не работает. С чего начать?
    kubectl get ingressclass — есть ли контроллер. Затем describe ingress и код ответа: 404 — правило не подошло, 503 — у сервиса нет готовых подов.
  • Почему описания Ingress плохо переносятся между контроллерами?
    Стандарт описывает только имя, путь и сервис. Переписывание путей, лимиты, таймауты задаются аннотациями конкретного контроллера.

Что дальше

В практике ты впустишь запросы к стенду снаружи по имени stand.provision.internal, срежешь /api и увидишь 404 от контроллера своими глазами.

Проверь себя+250 XPдве попытки
1
Правило и контроллер
Ingress создан, kubectl get ingress его показывает, но запросы не доходят. Что проверить первым?
2
Правило
По чему контроллер выбирает, какое правило применить к запросу?
3
Правило
Куда указывает правило Ingress?
4
Коды ответа
Вход отвечает 503. Где искать причину?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.