Provision
—— XP

Практика: сервис стенда

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

Четыре пода работают, но обратиться к ним по-человечески нельзя: адреса меняются при каждом пересоздании. Сервис даст им одно имя, и по этому имени к приложению будут ходить и соседи по кластеру, и Ingress в следующей части раздела.

А ещё ты один раз увидишь самую частую поломку в кластере — сервис, который выглядит здоровым и при этом никуда не ведёт.

Шаг 1. Описать сервис

В каталоге ~/infra/k8s/base открой nano 31-service.yaml и набери описание из урока.

31-service.yaml
apiVersion: v1
kind: Service
metadata:
  name: provision-app
  namespace: provision
spec:
  selector:
    app: provision-app
  ports:
    - port: 80
      targetPort: http

Номер 31 — сразу после Deployment: сервис без подов бесполезен, и в списке файлов он стоит следом.

Шаг 2. Применить

Отдай описание кластеру той же командой, что и Deployment.

ubuntu@stand:~$
kubectl apply -f 31-service.yaml
ubuntu@stand:~$
service/provision-app created

Шаг 3. Посмотреть на сервис

Проверь, какой адрес он получил.

ubuntu@stand:~$
kubectl get svc
ubuntu@stand:~$
NAME            TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)   AGE
provision-app   ClusterIP   10.43.112.87   <none>        80/TCP    5s

CLUSTER-IP — постоянный адрес сервиса внутри кластера, EXTERNAL-IP пуст: снаружи его не видно. Запоминать адрес не нужно, обращаться будем по имени.

Шаг 4. Кто за сервисом

Главная проверка любого сервиса — список конечных точек.

ubuntu@stand:~$
kubectl get endpoints provision-app
ubuntu@stand:~$
Warning: v1 Endpoints is deprecated in v1.33+; use discovery.k8s.io/v1 EndpointSlice
NAME            ENDPOINTS                                                AGE
provision-app   10.42.0.9:8000,10.42.1.14:8000,10.42.2.11:8000 + 1 more   10s

Четыре адреса — четыре готовых пода, + 1 more значит, что четвёртый не влез в строку. Первую строку, Warning, присылает сам кластер начиная с версии 1.33: старый объект Endpoints уступает место новому, EndpointSlice. Для чтения это неважно, адреса те же.

Шаг 5. Временный под для проверки

Сервис виден только изнутри кластера. Значит, и проверять его надо изнутри — из временного пода с busybox.

ubuntu@stand:~$
kubectl run tmp --rm -it --image=busybox -- sh
ubuntu@stand:~$
If you don't see a command prompt, try pressing enter.
/ #

Флаг --rm удалит под, когда ты выйдешь, флаги -i и -t дают терминал. Приглашение / # — ты внутри пода.

Шаг 6. Обратиться по имени

Внутри пода спроси приложение по имени сервиса. В busybox вместо curl есть wget.

ubuntu@stand:~$
/ # wget -qO- provision-app/health
ok
/ # wget -qO- provision-app/whoami
{"app":"provision-app","host":"provision-app-58c6d7f9b4-2kd9x","pid":8,"version":"1.0.0"}
/ # wget -qO- provision-app/whoami
{"app":"provision-app","host":"provision-app-58c6d7f9b4-ld7wz","pid":8,"version":"1.0.0"}

У wget флаг -q убирает служебные строки, а -O- печатает ответ на экран вместо файла. Обрати внимание на поле host: два одинаковых запроса попали в разные поды. Это балансировка, и отдельный балансировщик для неё не понадобился. Выйди командой exit — под удалится сам.

Шаг 7. Из чужого пространства

Повтори проверку, но запусти временный под в пространстве default.

ubuntu@stand:~$
kubectl run tmp -n default --rm -it --image=busybox -- sh
ubuntu@stand:~$
/ # wget -qO- provision-app/health
wget: bad address 'provision-app'
/ # wget -qO- provision-app.provision/health
ok

Флаг -n default запускает под в другом пространстве. Короткое имя оттуда не находится — bad address выглядит как поломка сети, но это поиск в своей папке. С названием пространства через точку всё работает. Выйди через exit.

Шаг 8. Сломать селектор

Теперь опечатка, которую делают каждый день. Поменяй в 31-service.yaml строку селектора на app: provision-apps — одна лишняя буква — и примени.

ubuntu@stand:~$
kubectl apply -f 31-service.yaml
ubuntu@stand:~$
service/provision-app configured
ubuntu@stand:~$
kubectl get endpoints provision-app
ubuntu@stand:~$
NAME            ENDPOINTS   AGE
provision-app   <none>      4m

Ни одного адреса. При этом apply прошёл без ошибок, kubectl get svc показывает сервис с адресом, а логи приложения чистые — до подов запросы просто не доходят.

Шаг 9. Найти расхождение

Поставь рядом две вещи: метки подов и селектор сервиса.

ubuntu@stand:~$
kubectl get pods --show-labels
ubuntu@stand:~$
NAME                             READY   STATUS    LABELS
provision-app-58c6d7f9b4-2kd9x   1/1     Running   app=provision-app,pod-template-hash=58c6d7f9b4

Флаг --show-labels добавляет колонку с метками. У подов app=provision-app — её ты написал в шаблоне. Вторую метку, pod-template-hash, Deployment ставит сам: это короткий отпечаток шаблона пода, по нему ReplicaSet отличает свои поды от подов прошлой версии. Тот же отпечаток стоит в середине имени пода.

ubuntu@stand:~$
kubectl describe svc provision-app | grep Selector
ubuntu@stand:~$
Selector:          app=provision-apps

А сервис ищет provision-apps. Расхождение видно глазами за десять секунд — если знать, куда смотреть.

Шаг 10. Починить

Верни в файле app: provision-app, примени и проверь, что адреса вернулись.

ubuntu@stand:~$
kubectl apply -f 31-service.yaml
ubuntu@stand:~$
service/provision-app configured
ubuntu@stand:~$
kubectl get endpoints provision-app
ubuntu@stand:~$
Warning: v1 Endpoints is deprecated in v1.33+; use discovery.k8s.io/v1 EndpointSlice
NAME            ENDPOINTS                                                AGE
provision-app   10.42.0.9:8000,10.42.1.14:8000,10.42.2.11:8000 + 1 more   5m

Шаг 11. Дотянуться со стенда

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

ubuntu@stand:~$
kubectl port-forward svc/provision-app 9000:80
ubuntu@stand:~$
Forwarding from 127.0.0.1:9000 -> 8000

Терминал занят туннелем. Открой второе окно (или новое окно tmux: Ctrl+B, затем C) и спроси приложение.

ubuntu@stand:~$
curl -s localhost:9000/whoami
ubuntu@stand:~$
{"app":"provision-app","host":"provision-app-58c6d7f9b4-8hq4n","pid":8,"version":"1.0.0"}

Флаг -s убирает индикатор загрузки. Ответ пришёл на стенд, мимо сервиса и узлов, прямо из пода: туннель слушает только 127.0.0.1 стенда. Закрой туннель в первом окне по Ctrl+C.

Что дальше

Приложение доступно по имени внутри кластера. Но настройки в нём пока зашиты в описание Deployment. Дальше — ConfigMap и Secret.

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

Дать подам постоянное имя через сервис и находить самую частую поломку сервиса — расхождение меток — по пустому списку конечных точек.

  • Сервис создан
  • Сервис нашёл поды
  • Опечатка в селекторе исправлена
Команда сдачи — выполни на своей машине
команда
kubectl -n provision get svc provision-app; kubectl -n provision get endpoints provision-app; grep -c 'provision-apps' ~/infra/k8s/base/31-service.yaml

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