Приложение отвечает внутри кластера, но со стенда до него не дотянуться без туннеля. Сейчас ты откроешь его по имени stand.provision.internal на порту 8090, который пробросил при создании кластера. Команды выполняй на стенде: имя пропишем в его /etc/hosts, и оно поведёт на 127.0.0.1 — на ту же машину, где работает k3d.
Шаг 1. Контроллер на месте
Прежде чем писать правила, убедись, что их будет кому читать.
kubectl get ingressclassNAME CONTROLLER PARAMETERS AGE traefik (default) traefik.io/ingress-controller <none> 3h
Класс traefik есть. Сам контроллер — обычный под в служебном пространстве.
kubectl get pods -n kube-system | grep traefikhelm-install-traefik-crd-97qhd 0/1 Completed 0 3h helm-install-traefik-k2ffq 0/1 Completed 2 3h svclb-traefik-9df4b089-6xtd9 2/2 Running 0 3h svclb-traefik-9df4b089-cqbv6 2/2 Running 0 3h svclb-traefik-9df4b089-ljd5z 2/2 Running 0 3h traefik-7c8544f77-h86vq 1/1 Running 0 3h
Флаг -n kube-system смотрит в чужое пространство на одну команду. Под traefik работает — вахтёр за стойкой.
Шаг 2. Порт для входа
Запросам снаружи нужен путь до контроллера: порт стенда, ведущий на порт 80 встроенного балансировщика кластера. Кластер пересоздавать не нужно — k3d умеет добавить порт к работающему. Флаг --port-add — какой порт стенда на какой порт узла, после @ — на каком узле, здесь на балансировщике.
Порт удобно положить в переменную шелла P, чтобы команда осталась короткой.
P=127.0.0.1:8090:80@loadbalancerk3d cluster edit stand --port-add $PINFO[0010] Starting node 'k3d-stand-serverlb' INFO[0017] Deleting old node k3d-stand-serverlb-JJtQI... INFO[0017] Successfully updated stand
k3d пересоздал только балансировщик, узлы и поды не тронуты. Адрес 127.0.0.1 — то же правило, что для API в первой практике раздела. Команда поменяла кластер, но не файл, а из файла кластер создаётся заново — в миссии раздела так и будет. Допиши в ~/infra/k8s/k3d.yaml тот же порт:
ports: - port: 127.0.0.1:8090:80 nodeFilters: - loadbalancer
nodeFilters — на каком узле открыть порт, здесь на балансировщике.
Шаг 3. Имя для стенда
Запросы будем отправлять по имени, как настоящие пользователи. Имя стенду ты давал в разделе 05 через файл /etc/hosts; проверь, что нужная строка там есть. Открой файл: sudo nano /etc/hosts (sudo — потому что файл принадлежит root). Если строки нет, допиши её в конец.
127.0.0.1 stand.provision.internalОкончание .internal выбрано не случайно: оно зарезервировано именно для внутренних имён и никогда не появится в интернете, а .local занято протоколом mDNS, которым устройства в домашней сети находят друг друга. Сохрани файл и спроси систему, знает ли она имя.
getent hosts stand.provision.internal127.0.0.1 stand.provision.internalgetent ищет имя так же, как любая программа на стенде, — сначала в /etc/hosts.
Шаг 4. Постучаться без правил
Посмотри, что отвечает вход, пока правил нет. Имя ведёт на твою же машину, порт 8090 — на балансировщик кластера.
curl -s stand.provision.internal:8090/whoami404 page not foundФлаг -s убирает индикатор загрузки. Этот ответ дал Traefik, а не приложение: запрос дошёл до контроллера, но правила для такого имени у него нет. Запомни, как выглядит его 404 — короткая строка без оформления.
Шаг 5. Правило: шапка
В каталоге ~/infra/k8s/base создай 41-ingress.yaml. Первый кусок — имя и класс контроллера.
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: provision namespace: provision spec: ingressClassName: traefik
Шаг 6. Правило: имя, путь и сервис
Ниже допиши, какие запросы ловить и куда отдавать. Начнём со всех путей: / с типом Prefix подходит под любой путь.
rules: - host: stand.provision.internal http: paths: - path: / pathType: Prefix backend: service: name: provision-app port: number: 80
kubectl apply -f 41-ingress.yamlingress.networking.k8s.io/provision createdkubectl get ingressNAME CLASS HOSTS ADDRESS PORTS AGE provision traefik stand.provision.internal 172.18.0.3,172.18.0.4,172.18.0.5 80 8s
Колонка ADDRESS заполнена — контроллер взял правило в работу. Пустая колонка значила бы, что правило никто не читает: не тот класс или контроллера нет.
Шаг 7. Открыть стенд
Повтори запрос из шага 4.
curl -s stand.provision.internal:8090/whoami{"app":"provision-app","host":"provision-app-7976fbd55b-fwg96","pid":7,"version":"1.0.0"}Теперь ответило приложение. Запрос прошёл весь путь: балансировщик k3d, Traefik, сервис выбрал под. Повтори команду пару раз — поле host будет меняться. Если стенд — твоя машина с графическим окружением, открой тот же адрес в браузере: он сам подставит заголовок Host, и ответ будет тем же.
Шаг 8. Чужое имя
Подставь в запрос заголовок с другим именем сайта.
curl -s -H 'Host: other.internal' localhost:8090/whoami404 page not foundФлаг -H добавляет заголовок к запросу — здесь он подменяет Host. Правило ждёт stand.provision.internal, имя не совпало, и Traefik ответил своим 404. До приложения запрос не дошёл, в его логах его нет. Это самая частая причина «в браузере работает, а через curl по адресу — нет».
Шаг 9. Приложение под /api
На одном имени обычно живёт и сайт, и API, и их разводят по путям: сайт на /, приложение — на /api. В правиле поменяй path: / на path: /api, примени и спроси приложение с новым путём.
curl -s stand.provision.internal:8090/api/whoami<!doctype html> <html lang=en> <title>404 Not Found</title> <h1>Not Found</h1>
Снова 404, но другой: оформленная страница, а не короткая строка. Это ответило само приложение — правило сработало, запрос дошёл до пода. Только путь пришёл к нему целиком, /api/whoami, а у приложения есть /whoami. Отличать эти два 404 — половина отладки Ingress.
Шаг 10. Обработчик, срезающий /api
Путь надо укоротить по дороге. В Traefik для этого есть обработчик — объект Middleware из урока. Создай файл с номером 40 — раньше правила, которое на него сошлётся.
apiVersion: traefik.io/v1alpha1 kind: Middleware metadata: name: strip-api namespace: provision spec: stripPrefix: prefixes: ["/api"]
kubectl apply -f 40-middleware.yamlmiddleware.traefik.io/strip-api createdПодключается обработчик аннотацией в шапке правила. Допиши её в 41-ingress.yaml под namespace:
annotations: traefik.ingress.kubernetes.io/router.middlewares: provision-strip-api@kubernetescrd
Значение — пространство имён, дефис, имя обработчика и @kubernetescrd. Набери его без ошибок: опечатка не даст ошибку при apply, а просто обработчик не подключится, и приложение снова получит путь с /api. Примени правило и повтори запрос.
curl -s stand.provision.internal:8090/api/whoami{"app":"provision-app","host":"provision-app-7976fbd55b-787sz","pid":7,"version":"1.0.0"}Шаг 11. Разобрать правило
Попроси подробности о правиле.
kubectl describe ingress provisionName: provision Namespace: provision Ingress Class: traefik Rules: Host Path Backends ---- ---- -------- stand.provision.internal /api provision-app:80 (10.42.0.12:8000,10.42.2.13:8000,10.42.1.10:8000 + 1 more...) Annotations: traefik.ingress.kubernetes.io/router.middlewares: provision-strip-api@kubernetescrd
Здесь вся цепочка в одном месте: какое имя, какой путь, какой сервис и — в скобках — адреса подов за ним. Если вместо адресов там <error: endpoints not found>, дело в сервисе, а не в правиле.
Что дальше
Стенд открывается по имени. Все его части лежат в ~/infra/k8s/base отдельными файлами — в миссии ты добавишь базу, соберёшь всё вместе и развернёшь на пустом кластере с нуля.