Provision
—— XP

Практика: кластер за минуту

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

Настоящий кластер из трёх серверов для учёбы не нужен. Есть k3s — облегчённый Kubernetes от компании Rancher, который ставится одним файлом, и есть k3d — программа, которая запускает k3s прямо внутри контейнеров Docker. Каждый «узел» такого кластера — обычный контейнер, поэтому кластер поднимается за минуту и удаляется за секунду.

Всё в разделе делается на стенде — той же машине, где работает Docker из раздела 07. Команды kubectl, curl и port-forward в этом разделе тоже запускаются на стенде, а не на ноутбуке, с которого ты к нему подключён по SSH.

Разговаривать с кластером будешь через kubectl (читают «куб-контрол» или «куб-си-ти-эль») — программу, которая отправляет запросы в API-сервер и печатает ответы. Сама она ничего не запускает, она только посыльный.

Шаг 1. Освободить память

Кластеру из трёх узлов нужно около полутора гигабайт памяти. GitLab из раздела 12 держит около шести, и на стенде с 8 ГБ вместе они не уживутся: поды начнут молча падать, а ты будешь искать ошибку в своём YAML. Останови GitLab — данные лежат на диске и никуда не денутся.

ubuntu@stand:~$
docker compose -f ~/gitlab/compose.yaml stop
ubuntu@stand:~$
[+] Stopping 1/1
 ✔ Container gitlab  Stopped

Флаг -f указывает файл Compose, чтобы не переходить в его каталог. Теперь посмотри, сколько памяти свободно.

ubuntu@stand:~$
free -h
ubuntu@stand:~$
               total        used        free      shared  buff/cache   available
Mem:           7.7Gi       1.9Gi       3.1Gi        12Mi       2.9Gi       5.6Gi

Смотри на колонку available — сколько память реально можно отдать новым программам. Для раздела хватит трёх гигабайт. Стенд Compose и мониторинг из разделов 08–10 можно оставить, если available не меньше трёх; иначе останови и их тем же docker compose stop в их каталогах.

Шаг 2. Поставить k3d

У k3d официальная установка — одна строка со скриптом, она опубликована на странице k3d.io в разделе Installation. Скопируй оттуда строку, которая начинается с wget и заканчивается на TAG=v5.0.0 bash, и замени в ней версию на v5.9.0. Скрипт сам определит, какой у стенда процессор (обычный amd64 или arm64 на Mac с чипом M), скачает нужную сборку и положит программу в /usr/local/bin.

Версию закрепляем нарочно. Без TAG скрипт поставит самую свежую k3d, а у неё свой Kubernetes по умолчанию — и через полгода у тебя на экране будет не то, что в уроке.

ubuntu@stand:~$
k3d version
ubuntu@stand:~$
k3d version v5.9.0
k3s version v1.35.5-k3s1 (default)

Две строки: версия самой k3d и версия Kubernetes, который она поставила бы по умолчанию. Мы её не возьмём: кластер получит версию, записанную в его файле, — это шаг 5.

Шаг 3. Поставить kubectl

kubectl удобнее всего поставить через snap — магазин программ Ubuntu, который сам их обновляет.

ubuntu@stand:~$
sudo snap install kubectl --classic --channel=1.36/stable
ubuntu@stand:~$
kubectl (1.36/stable) v1.36.5 from Canonical✓ installed

Флаг --classic разрешает программе работать со всей системой (иначе snap держит её в песочнице и kubectl не увидит свой файл настроек). Параметр --channel выбирает ветку версий: kubectl должен быть не старше и не новее кластера больше чем на одну версию, а кластер у нас будет 1.36 — одна из трёх веток Kubernetes, которые на осень 2026 года ещё получают исправления.

ubuntu@stand:~$
kubectl version --client
ubuntu@stand:~$
Client Version: v1.36.5
Kustomize Version: v5.8.1

Параметр --client печатает только версию самой программы, не пытаясь связаться с кластером, — кластера ведь ещё нет. Вторая строка — встроенный в kubectl Kustomize, инструмент для наложения правок на YAML-файлы под разные окружения; в курсе он не понадобится, похожую задачу решит Helm в разделе 17.

Шаг 4. Файл кластера

Параметров у кластера со временем набирается много: число узлов, версия, порты. Командой их не перечислить — она выйдет длиной в строку и потеряется. Поэтому опишем кластер файлом и положим его в репозиторий ~/infra, рядом с остальным стендом.

ubuntu@stand:~$
mkdir -p ~/infra/k8s

Открой nano ~/infra/k8s/k3d.yaml и начни с самого малого: имя и версия.

k3d.yaml
apiVersion: k3d.io/v1alpha5
kind: Simple
metadata:
  name: stand
image: rancher/k3s:v1.36.5-k3s1

Первые две строки говорят k3d, что это его файл и какой версии формат. name: stand — имя кластера, как и всего стенда курса. image закрепляет версию Kubernetes — ту же 1.36, что у kubectl. Сохрани файл: Ctrl+O, Enter, Ctrl+X.

Шаг 5. Создать кластер

Отдай файл k3d. Флаг --config указывает файл с описанием.

ubuntu@stand:~$
k3d cluster create --config ~/infra/k8s/k3d.yaml
ubuntu@stand:~$
INFO[0000] Created network 'k3d-stand'
INFO[0012] Starting node 'k3d-stand-server-0'
INFO[0018] Starting node 'k3d-stand-serverlb'
INFO[0027] Cluster 'stand' created successfully!

Заодно k3d сам записал адрес кластера и ключи в файл ~/.kube/config и переключил kubectl на новый кластер. Этот файл называют kubeconfig, и любая команда kubectl первым делом читает его. Первое, что смотрят на любом кластере, — живы ли узлы.

ubuntu@stand:~$
kubectl get nodes
ubuntu@stand:~$
NAME                 STATUS   ROLES           AGE   VERSION
k3d-stand-server-0   Ready    control-plane   9s    v1.36.5+k3s1

Один узел, управляющий — это видно по колонке ROLES. Главная колонка — STATUS: Ready значит, что агент на узле отвечает и узел готов принимать нагрузку. Кластер из двух строк описания уже работает.

Шаг 6. Узлы — это контейнеры

Убедись, что «машина» кластера на самом деле контейнер Docker. Флаг --format оставляет только имена и порты, а grep — контейнеры кластера.

ubuntu@stand:~$
docker ps --format '{{.Names}}  {{.Ports}}' | grep k3d
ubuntu@stand:~$
k3d-stand-serverlb  80/tcp, 0.0.0.0:44519->6443/tcp
k3d-stand-server-0

Узел плюс балансировщик serverlb, через который ходит kubectl. И у балансировщика неприятная строка: 0.0.0.0:44519->6443 — API кластера, где лежат ключи администратора, опубликован на всех адресах машины, на случайном порту. Помни правило раздела 07: порт, опубликованный Docker без адреса, открыт всей сети в обход ufw.

Шаг 7. Пересоздать как надо

Кластер одноразовый, пересоздать его дешевле, чем чинить. Удали:

ubuntu@stand:~$
k3d cluster delete stand
ubuntu@stand:~$
INFO[0002] Successfully deleted cluster stand!

Допиши в k3d.yaml две вещи: рабочие узлы и адрес для API.

k3d.yaml, в конец
agents: 2
kubeAPI:
  hostIP: 127.0.0.1
  hostPort: "6550"

agents: 2 добавляет два рабочих узла к одному управляющему: на одном узле не видно, как кластер раскладывает нагрузку. kubeAPI — где на стенде будет слушать API-сервер кластера: адрес 127.0.0.1 и постоянный порт 6550. Создай кластер той же командой из шага 5 и снова посмотри узлы.

ubuntu@stand:~$
kubectl get nodes
ubuntu@stand:~$
NAME                 STATUS   ROLES           AGE   VERSION
k3d-stand-agent-0    Ready    <none>          8s    v1.36.5+k3s1
k3d-stand-agent-1    Ready    <none>          8s    v1.36.5+k3s1
k3d-stand-server-0   Ready    control-plane   12s   v1.36.5+k3s1

Три узла: server-0 — управляющий, два agent — рабочие. NotReady в первые секунды бывает, через минуту — повод разбираться. И порт:

ubuntu@stand:~$
docker ps --format '{{.Names}}  {{.Ports}}' | grep k3d
ubuntu@stand:~$
k3d-stand-serverlb  80/tcp, 127.0.0.1:6550->6443/tcp
k3d-stand-agent-1
k3d-stand-agent-0
k3d-stand-server-0

API кластера теперь только для этой машины. Рядом в общем списке docker ps будут и контейнеры прошлых разделов, если ты их не останавливал. Именно поэтому кластер одноразовый: удалить его — значит удалить четыре контейнера.

Шаг 8. Системные поды

Внутри кластера уже работают его собственные служебные программы. Посмотри на них.

ubuntu@stand:~$
kubectl get pods -A
ubuntu@stand:~$
NAMESPACE     NAME                                      READY   STATUS      RESTARTS   AGE
kube-system   coredns-7cfb7bc9c7-vfhfk                  1/1     Running     0          2m
kube-system   helm-install-traefik-crd-97qhd            0/1     Completed   0          2m
kube-system   helm-install-traefik-k2ffq                0/1     Completed   2          2m
kube-system   local-path-provisioner-77b9867795-4g7k8   1/1     Running     0          2m
kube-system   metrics-server-6dc596dfb8-476kd           1/1     Running     0          2m
kube-system   svclb-traefik-9df4b089-6xtd9              2/2     Running     0          2m
kube-system   svclb-traefik-9df4b089-cqbv6              2/2     Running     0          2m
kube-system   svclb-traefik-9df4b089-ljd5z              2/2     Running     0          2m
kube-system   traefik-7c8544f77-h86vq                   1/1     Running     0          2m

Флаг -A (от all namespaces) показывает поды всех пространств имён сразу. Что такое под, разберём в следующем уроке, а пока прочитай по именам: coredns — имена внутри кластера, local-path-provisioner — диски, metrics-server — метрики, traefik — вход снаружи. Три пода svclb-traefik — по одному на узел: так k3s раздаёт порт traefik на все узлы, их число всегда равно числу узлов.

Completed у двух helm-install-traefik — не ошибка: это разовые задачи, которые поставили traefik и завершились. Первая поставила новые виды объектов для traefik, вторая — сам traefik. Пока они не Completed, traefik ещё ставится; в первую минуту такая задача бывает и в Error с одним-двумя перезапусками — она ждёт первую и повторяет сама. Если через три минуты задачи всё ещё не Completed, дело в кластере.

Если какой-то из системных подов не Running, чинить надо кластер, а не приложение.

Шаг 9. Своё пространство имён

Объекты кластера раскладываются по пространствам имён (namespace) — это как папки. Заведём папку для стенда.

ubuntu@stand:~$
kubectl create namespace provision
ubuntu@stand:~$
namespace/provision created

Шаг 10. Сделать его текущим

Без этого каждую команду пришлось бы дополнять флагом -n provision. Скажем kubectl один раз, куда смотреть по умолчанию.

ubuntu@stand:~$
kubectl config set-context --current --namespace=provision
ubuntu@stand:~$
Context "k3d-stand" modified.

Параметр --current меняет текущую запись в kubeconfig (её называют контекстом: какой кластер и под каким пользователем), а --namespace задаёт папку по умолчанию. Флаг -n при этом никуда не делся: им смотрят в чужое пространство на одну команду.

Шаг 11. Проверить, куда смотрит kubectl

Прочитай свою запись в kubeconfig.

ubuntu@stand:~$
kubectl config view --minify | grep namespace
ubuntu@stand:~$
    namespace: provision

Параметр --minify оставляет в выводе только текущий контекст, а grep выбирает из него нужную строку. Пусто — значит шаг 11 не сработал.

Шаг 12. Выключать и включать

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

ubuntu@stand:~$
k3d cluster stop stand    # остановить, всё сохранится
k3d cluster start stand   # запустить снова
k3d cluster list          # какие кластеры есть

Удалять кластер пока не надо: он понадобится до конца раздела. А когда сломаешь его так, что неясно, как чинить, помни, что k3d cluster delete stand и новый k3d cluster create --config ~/infra/k8s/k3d.yaml займут минуту — это быстрее любой починки. Файл кластера лежит в репозитории, поэтому новый кластер выйдет точно таким же. Закоммить его в той ветке, где работаешь, — в миссии раздела он понадобится.

Что дальше

Кластер работает. Дальше — что такое под, на котором держится весь раздел.

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

Поднять учебный кластер на стенде, убедиться, что узлы готовы, и настроить kubectl на своё пространство имён.

  • Управляющий узел готов
  • Два рабочих узла готовы
  • Текущее пространство имён — provision
Команда сдачи — выполни на своей машине
команда
kubectl get nodes; kubectl config view --minify | grep namespace

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