Provision
—— XP

Практика: вход в стенд снаружи

практика~30 минут+625 XP

Приложение отвечает внутри кластера, но со стенда до него не дотянуться без туннеля. Сейчас ты откроешь его по имени stand.provision.internal на порту 8090, который пробросил при создании кластера. Команды выполняй на стенде: имя пропишем в его /etc/hosts, и оно поведёт на 127.0.0.1 — на ту же машину, где работает k3d.

Шаг 1. Контроллер на месте

Прежде чем писать правила, убедись, что их будет кому читать.

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

Класс traefik есть. Сам контроллер — обычный под в служебном пространстве.

ubuntu@stand:~$
kubectl get pods -n kube-system | grep traefik
ubuntu@stand:~$
helm-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, чтобы команда осталась короткой.

ubuntu@stand:~$
P=127.0.0.1:8090:80@loadbalancer
ubuntu@stand:~$
k3d cluster edit stand --port-add $P
ubuntu@stand:~$
INFO[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 тот же порт:

~/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). Если строки нет, допиши её в конец.

/etc/hosts, строка в конце
127.0.0.1 stand.provision.internal

Окончание .internal выбрано не случайно: оно зарезервировано именно для внутренних имён и никогда не появится в интернете, а .local занято протоколом mDNS, которым устройства в домашней сети находят друг друга. Сохрани файл и спроси систему, знает ли она имя.

ubuntu@stand:~$
getent hosts stand.provision.internal
ubuntu@stand:~$
127.0.0.1       stand.provision.internal

getent ищет имя так же, как любая программа на стенде, — сначала в /etc/hosts.

Шаг 4. Постучаться без правил

Посмотри, что отвечает вход, пока правил нет. Имя ведёт на твою же машину, порт 8090 — на балансировщик кластера.

ubuntu@stand:~$
curl -s stand.provision.internal:8090/whoami
ubuntu@stand:~$
404 page not found

Флаг -s убирает индикатор загрузки. Этот ответ дал Traefik, а не приложение: запрос дошёл до контроллера, но правила для такого имени у него нет. Запомни, как выглядит его 404 — короткая строка без оформления.

Шаг 5. Правило: шапка

В каталоге ~/infra/k8s/base создай 41-ingress.yaml. Первый кусок — имя и класс контроллера.

nano 41-ingress.yaml, часть 1
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: provision
  namespace: provision
spec:
  ingressClassName: traefik

Шаг 6. Правило: имя, путь и сервис

Ниже допиши, какие запросы ловить и куда отдавать. Начнём со всех путей: / с типом Prefix подходит под любой путь.

41-ingress.yaml, часть 2
  rules:
    - host: stand.provision.internal
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: provision-app
                port:
                  number: 80
ubuntu@stand:~$
kubectl apply -f 41-ingress.yaml
ubuntu@stand:~$
ingress.networking.k8s.io/provision created
ubuntu@stand:~$
kubectl get ingress
ubuntu@stand:~$
NAME        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.

ubuntu@stand:~$
curl -s stand.provision.internal:8090/whoami
ubuntu@stand:~$
{"app":"provision-app","host":"provision-app-7976fbd55b-fwg96","pid":7,"version":"1.0.0"}

Теперь ответило приложение. Запрос прошёл весь путь: балансировщик k3d, Traefik, сервис выбрал под. Повтори команду пару раз — поле host будет меняться. Если стенд — твоя машина с графическим окружением, открой тот же адрес в браузере: он сам подставит заголовок Host, и ответ будет тем же.

Шаг 8. Чужое имя

Подставь в запрос заголовок с другим именем сайта.

ubuntu@stand:~$
curl -s -H 'Host: other.internal' localhost:8090/whoami
ubuntu@stand:~$
404 page not found

Флаг -H добавляет заголовок к запросу — здесь он подменяет Host. Правило ждёт stand.provision.internal, имя не совпало, и Traefik ответил своим 404. До приложения запрос не дошёл, в его логах его нет. Это самая частая причина «в браузере работает, а через curl по адресу — нет».

Шаг 9. Приложение под /api

На одном имени обычно живёт и сайт, и API, и их разводят по путям: сайт на /, приложение — на /api. В правиле поменяй path: / на path: /api, примени и спроси приложение с новым путём.

ubuntu@stand:~$
curl -s stand.provision.internal:8090/api/whoami
ubuntu@stand:~$
<!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 — раньше правила, которое на него сошлётся.

nano 40-middleware.yaml
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: strip-api
  namespace: provision
spec:
  stripPrefix:
    prefixes: ["/api"]
ubuntu@stand:~$
kubectl apply -f 40-middleware.yaml
ubuntu@stand:~$
middleware.traefik.io/strip-api created

Подключается обработчик аннотацией в шапке правила. Допиши её в 41-ingress.yaml под namespace:

41-ingress.yaml, в metadata
  annotations:
    traefik.ingress.kubernetes.io/router.middlewares: provision-strip-api@kubernetescrd

Значение — пространство имён, дефис, имя обработчика и @kubernetescrd. Набери его без ошибок: опечатка не даст ошибку при apply, а просто обработчик не подключится, и приложение снова получит путь с /api. Примени правило и повтори запрос.

ubuntu@stand:~$
curl -s stand.provision.internal:8090/api/whoami
ubuntu@stand:~$
{"app":"provision-app","host":"provision-app-7976fbd55b-787sz","pid":7,"version":"1.0.0"}

Шаг 11. Разобрать правило

Попроси подробности о правиле.

ubuntu@stand:~$
kubectl describe ingress provision
ubuntu@stand:~$
Name:             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 отдельными файлами — в миссии ты добавишь базу, соберёшь всё вместе и развернёшь на пустом кластере с нуля.

Практика 06+625 XP

Выпустить приложение из кластера наружу по имени и пути через Ingress и отличать 404 от контроллера от ответа самого приложения.

  • Стенд отвечает снаружи
  • Контроллер взял правило
Команда сдачи — выполни на своей машине
команда
curl -s stand.provision.internal:8090/api/whoami; echo; kubectl -n provision get ingress provision

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