Установка инструментов разработчика и обзор d8 CLI

Что нужно знать перед уроком

M0 урок 1 — общая карта: Kubernetes/Deckhouse/Werf/Nelm/Application/Registry. В этом уроке мы устанавливаем всё, что нужно для практики, и подробно разбираем d8 — единую CLI-утилиту платформы Deckhouse, которая будет использоваться в каждом последующем модуле.

Теория

Набор инструментов разработчика Application

trdl — единый механизм установки и обновления

Инструменты экосистемы Werf/Deckhouse ставятся не через apt/brew, а через собственный механизм trdl (The Update Framework-совместимый транспорт с верификацией подписи и поддержкой каналов обновления alpha/beta/early-access/stable/rock-solid, аналогичных release channels самого Deckhouse). Общая схема:

1
2
3
4
5

# Добавляем репозиторий инструмента (пример для d8)
trdl add d8 https://deckhouse.ru/downloads/deckhouse-cli-trdl 1 <root-sha512>
# Подключаем канал stable, группа версий 0, в текущей сессии шелла
. $(trdl use d8 0 stable)
d8 --version

Тот же механизм используется для werf:

1
2
3

trdl add werf https://tuf.werf.io 1 <root-sha512> werf
trdl use werf 2 stable
werf version

kubectl — универсальный клиент Kubernetes API

kubectl — официальный CLI-клиент для любого Kubernetes API, независимо от дистрибутива. Устанавливается стандартно (пакетный менеджер ОС или официальный бинарник с kubernetes.io). Все команды kubectl get/describe/apply/logs/exec будут работать одинаково в кластере kind из следующего урока и в любом продакшен-кластере Deckhouse.

d8 — CLI-утилита платформы Deckhouse: полный обзор групп команд

d8 — не замена kubectl, а надстройка: часть команд (d8 k) — прямой аналог kubectl, работающий через тот же kubeconfig, а остальные группы — платформенные операции, которых в чистом Kubernetes просто не существует. Официальная таблица групп команд (Deckhouse — CLI d8):

d8 plugins — механизм подгружаемых расширений CLI

Механизм d8 plugins по-прежнему существует для прочих версионируемых расширений CLI (не для d8 package в актуальных релизах). Плагины скачиваются компонентом кластера registry-packages-proxy по Bearer-токену из kubeconfig; авторизация — через ClusterRole d8:registry-packages-proxy:cli-download, который выдаёт администратор кластера.

1
2
3
4
5
6
7
8
9

d8 plugins list                          # какие плагины установлены
d8 plugins versions <name>               # доступные версии плагина
d8 plugins install <name>                # установить последнюю совместимую версию
d8 plugins install <name> --version 1.4.0
d8 plugins install <name> --use-major 1
d8 plugins update <name>                 # обновить один плагин
d8 plugins update all                    # обновить все установленные плагины
d8 plugins contract <name>               # версия API-контракта плагина (для совместимости с версией d8)
d8 plugins remove <name>

Жизненный цикл Application-пакета через d8 package bootstrap/build/verify разбирается практически в M5 уроке 9.

werf и nelm

werf — самодостаточный бинарник, nelm используется werf’ом «под капотом» при werf converge, но также может вызываться отдельно как самостоятельный CLI (nelm release ..., nelm chart ...) — это разбирается подробно в M4.

Linux / Сети

PATH, права и ~/.kube/config

Все перечисленные инструменты — обычные исполняемые файлы. После установки через trdl команда доступна в текущей сессии шелла только после того, как вы явно выполнили . $(trdl use d8 0 stable) (это подключает нужную версию, а не запускает её напрямую) — чтобы не делать это перед каждым вызовом, добавьте в ~/.bashrc/~/.zshrc alias вручную, например alias d8='trdl exec d8 0 stable -- "$@"', и затем source ~/.bashrc/source ~/.zshrc.

1
2

echo $PATH                     # проверить, что каталоги с бинарниками в PATH
chmod +x ./kubectl              # если скачали бинарник вручную — не забудьте exec-бит

kubectl/d8 k подключаются к кластеру через файл kubeconfig — YAML с адресом API-сервера, сертификатами клиента и контекстами (какой кластер/namespace/пользователь используется «по умолчанию»). Путь к нему — переменная окружения KUBECONFIG, по умолчанию ~/.kube/config:

1
2
3
4

export KUBECONFIG=~/.kube/config
kubectl config view --minify         # что реально сейчас используется
kubectl config get-contexts
kubectl config use-context <name>

В следующем уроке kind автоматически запишет новый контекст в этот файл — важно понимать, откуда он берётся, чтобы не терять время на диагностику «кластер не отвечает» из-за неверного контекста.

Частые ошибки и подводные камни

• Путать kubectl и d8 k. Это не два разных инструмента с разным поведением — d8 k буквально проксирует в kubectl с тем же kubeconfig. Разница появляется только в специфичных для Deckhouse удобствах (например, автодополнение CRD платформы). В этом курсе команды d8 k и kubectl взаимозаменяемы, если не сказано иное.
• Использовать устаревшую версию deckhouse-cli, где d8 package ещё был плагином. В DKP 1.76+ команда встроена; если d8 package --help не работает — обновите d8 через trdl, а не ставьте legacy-плагин.
• Забыть, что d8 mirror/d8 delivery-kit недоступны в Community Edition. Если проходите курс на CE-кластере (как в M0 уроке 3) — эти группы не будут работать, это ожидаемо, не тратьте время на диагностику.

Практика в кластере

Кластера пока нет — он появится в следующем уроке. Однако сами инструменты уже можно и нужно поставить и проверить их версии:

1
2
3
4
5

git --version
docker --version           # или podman --version
kubectl version --client
d8 --version
werf version

Если какая-то команда не найдена — вернитесь к разделу «Linux / Сети» этого урока и проверьте PATH/rc-файл шелла.

Практика разработки

В этом уроке практики сборки/деплоя ещё нет — она появится с M3, когда у нас будет и код приложения, и работающий кластер.

Шпаргалка команд урока

1
2
3
4
5
6

trdl add <tool> <repo-url> <root-version> <root-sha512>
trdl use <tool> <group> <channel>
d8 plugins list|versions|install|update|contract|remove <name>
kubectl config view --minify
kubectl config get-contexts
kubectl config use-context <name>

Полная шпаргалка по d8 (с обновлением после каждого нового модуля) — 📋 cheatsheets/d8 .

Вопросы для самопроверки

Рекомендуемая литература

Официальная документация

• Deckhouse — Deckhouse CLI (d8)
• GitHub — deckhouse/deckhouse-cli — internal/docs/plugins.md
• kubernetes.io — Organizing Cluster Access with kubeconfig Files.
• ru.werf.io — установка.

Статьи и блоги

• Установка Deckhouse в kind: пробуем K8s-платформу на ноутбуке — Flant на Habr.
• Разворачиваем приложение в кластере Kubernetes под управлением Deckhouse c помощью werf — Flant на Habr.
• Первые шаги с werf: собираем и деплоим простое приложение в Kubernetes — Flant на Habr.

Книги

• Marko Lukša. Kubernetes in Action. 2nd ed., 2022. ISBN 978-1617297618.

Связанные материалы

• Предыдущий урок: M0.01 — Карта экосистемы.
• Следующий урок: M0.03 — Практический кластер: kind + Deckhouse CE.
• Шпаргалка: 📋 d8 , 📋 kubectl .
• Глубже про d8 package — M5 урок 9; про остальные группы d8 — M2 урок 2.

✓ Урок пройден — все вопросы самопроверки отвечены верно