Настоящий кластер из трёх серверов для учёбы не нужен. Есть k3s — облегчённый Kubernetes от компании Rancher, который ставится одним файлом, и есть k3d — программа, которая запускает k3s прямо внутри контейнеров Docker. Каждый «узел» такого кластера — обычный контейнер, поэтому кластер поднимается за минуту и удаляется за секунду.
Всё в разделе делается на стенде — той же машине, где работает Docker из раздела 07. Команды kubectl, curl и port-forward в этом разделе тоже запускаются на стенде, а не на ноутбуке, с которого ты к нему подключён по SSH.
Разговаривать с кластером будешь через kubectl (читают «куб-контрол» или «куб-си-ти-эль») — программу, которая отправляет запросы в API-сервер и печатает ответы. Сама она ничего не запускает, она только посыльный.
Шаг 1. Освободить память
Кластеру из трёх узлов нужно около полутора гигабайт памяти. GitLab из раздела 12 держит около шести, и на стенде с 8 ГБ вместе они не уживутся: поды начнут молча падать, а ты будешь искать ошибку в своём YAML. Останови GitLab — данные лежат на диске и никуда не денутся.
docker compose -f ~/gitlab/compose.yaml stop[+] Stopping 1/1 ✔ Container gitlab Stopped
Флаг -f указывает файл Compose, чтобы не переходить в его каталог. Теперь посмотри, сколько памяти свободно.
free -htotal 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 по умолчанию — и через полгода у тебя на экране будет не то, что в уроке.
k3d versionk3d version v5.9.0 k3s version v1.35.5-k3s1 (default)
Две строки: версия самой k3d и версия Kubernetes, который она поставила бы по умолчанию. Мы её не возьмём: кластер получит версию, записанную в его файле, — это шаг 5.
Шаг 3. Поставить kubectl
kubectl удобнее всего поставить через snap — магазин программ Ubuntu, который сам их обновляет.
sudo snap install kubectl --classic --channel=1.36/stablekubectl (1.36/stable) v1.36.5 from Canonical✓ installedФлаг --classic разрешает программе работать со всей системой (иначе snap держит её в песочнице и kubectl не увидит свой файл настроек). Параметр --channel выбирает ветку версий: kubectl должен быть не старше и не новее кластера больше чем на одну версию, а кластер у нас будет 1.36 — одна из трёх веток Kubernetes, которые на осень 2026 года ещё получают исправления.
kubectl version --clientClient Version: v1.36.5 Kustomize Version: v5.8.1
Параметр --client печатает только версию самой программы, не пытаясь связаться с кластером, — кластера ведь ещё нет. Вторая строка — встроенный в kubectl Kustomize, инструмент для наложения правок на YAML-файлы под разные окружения; в курсе он не понадобится, похожую задачу решит Helm в разделе 17.
Шаг 4. Файл кластера
Параметров у кластера со временем набирается много: число узлов, версия, порты. Командой их не перечислить — она выйдет длиной в строку и потеряется. Поэтому опишем кластер файлом и положим его в репозиторий ~/infra, рядом с остальным стендом.
mkdir -p ~/infra/k8sОткрой nano ~/infra/k8s/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 указывает файл с описанием.
k3d cluster create --config ~/infra/k8s/k3d.yamlINFO[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 первым делом читает его. Первое, что смотрят на любом кластере, — живы ли узлы.
kubectl get nodesNAME STATUS ROLES AGE VERSION k3d-stand-server-0 Ready control-plane 9s v1.36.5+k3s1
Один узел, управляющий — это видно по колонке ROLES. Главная колонка — STATUS: Ready значит, что агент на узле отвечает и узел готов принимать нагрузку. Кластер из двух строк описания уже работает.
Шаг 6. Узлы — это контейнеры
Убедись, что «машина» кластера на самом деле контейнер Docker. Флаг --format оставляет только имена и порты, а grep — контейнеры кластера.
docker ps --format '{{.Names}} {{.Ports}}' | grep k3dk3d-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. Пересоздать как надо
Кластер одноразовый, пересоздать его дешевле, чем чинить. Удали:
k3d cluster delete standINFO[0002] Successfully deleted cluster stand!Допиши в k3d.yaml две вещи: рабочие узлы и адрес для API.
agents: 2 kubeAPI: hostIP: 127.0.0.1 hostPort: "6550"
agents: 2 добавляет два рабочих узла к одному управляющему: на одном узле не видно, как кластер раскладывает нагрузку. kubeAPI — где на стенде будет слушать API-сервер кластера: адрес 127.0.0.1 и постоянный порт 6550. Создай кластер той же командой из шага 5 и снова посмотри узлы.
kubectl get nodesNAME 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 в первые секунды бывает, через минуту — повод разбираться. И порт:
docker ps --format '{{.Names}} {{.Ports}}' | grep k3dk3d-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. Системные поды
Внутри кластера уже работают его собственные служебные программы. Посмотри на них.
kubectl get pods -ANAMESPACE 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) — это как папки. Заведём папку для стенда.
kubectl create namespace provisionnamespace/provision createdШаг 10. Сделать его текущим
Без этого каждую команду пришлось бы дополнять флагом -n provision. Скажем kubectl один раз, куда смотреть по умолчанию.
kubectl config set-context --current --namespace=provisionContext "k3d-stand" modified.Параметр --current меняет текущую запись в kubeconfig (её называют контекстом: какой кластер и под каким пользователем), а --namespace задаёт папку по умолчанию. Флаг -n при этом никуда не делся: им смотрят в чужое пространство на одну команду.
Шаг 11. Проверить, куда смотрит kubectl
Прочитай свою запись в kubeconfig.
kubectl config view --minify | grep namespace namespace: provisionПараметр --minify оставляет в выводе только текущий контекст, а grep выбирает из него нужную строку. Пусто — значит шаг 11 не сработал.
Шаг 12. Выключать и включать
Кластер занимает около полутора гигабайт памяти. Когда он не нужен, его можно остановить, не теряя содержимого.
k3d cluster stop stand # остановить, всё сохранится k3d cluster start stand # запустить снова k3d cluster list # какие кластеры есть
Удалять кластер пока не надо: он понадобится до конца раздела. А когда сломаешь его так, что неясно, как чинить, помни, что k3d cluster delete stand и новый k3d cluster create --config ~/infra/k8s/k3d.yaml займут минуту — это быстрее любой починки. Файл кластера лежит в репозитории, поэтому новый кластер выйдет точно таким же. Закоммить его в той ветке, где работаешь, — в миссии раздела он понадобится.
Что дальше
Кластер работает. Дальше — что такое под, на котором держится весь раздел.