РоссияСтатьяПрактика
Sextant 0.30: ядро ушло в расширения
В версии 0.30 из ядра Sextant вынесена 31 встроенная интеграция: Flux, Argo CD, cert-manager, Istio и Linkerd, Crossplane и другие. Теперь это отдельные расширения из каталога, написанные только на публичном SDK — том же, что доступен любому автору. Код окна похудел с 209 до 170 тысяч строк TypeScript, а API расширений дорос до пятой версии.
Sextant — бесплатный десктопный клиент Kubernetes на Rust и Tauri 2, замена Lens со встроенным MCP-сервером. Он бесплатный и таким останется. Весь код сгенерирован Claude Code: человек ставит задачи, принимает архитектурные решения и делает ревью, а каждое изменение проходит более 6800 тестов на трёх ОС.
Как устроена сама песочница, мы подробно рассказывали в прошлой статье. Здесь — что изменилось в 0.30 и как устроена модульность.
Что ушло из ядра
Область
Расширения
GitOps и доставка
Flux, Argo CD, Argo Rollouts, Argo Workflows
Сеть
Istio и Linkerd, Traefik, Contour, Knative, OpenShift
Безопасность и секреты
cert-manager, Trivy, Kyverno, External Secrets, Sealed Secrets
Данные и хранение
CloudNativePG, Strimzi, Velero, Rook Ceph
Масштабирование
KEDA, Karpenter, Vertical Pod Autoscaler
ML и батчи
Kueue, JobSet, KubeRay, KServe, DRA, NVIDIA GPU Operator
Платформы и операторы
Crossplane, Cluster API, OLM, k3s / RKE2, Prometheus Operator
Всего в каталоге 32 расширения команды Sextant: 31 вынесенное и Rook Ceph, которое сразу писалось расширением. У каждого свои версии и свой цикл релизов: исправление для Knative больше не ждёт релиза клиента.
В ядре осталось то, что нужно любому кластеру: таблицы и детали ресурсов, редактор, логи, терминалы, Helm, метрики, проблемы, RBAC, сетевые политики, Gateway API, MCP-сервер и сама платформа расширений.
Для тех, кто обновляется, ничего не пропадает:
- если в кластере работает один из этих инструментов, боковое меню предложит поставить его расширение;
- разделы расширений встают на те же места в меню, где были встроенные;
- настройки уведомлений и доступ агентов к проблемам один раз переносятся на новые категории.
Архитектура: сначала данные, код — если без него никак
Расширение состоит из трёх слоёв, и каждый следующий нужен реже предыдущего.
Манифест. Виды объектов в таблицах Sextant, вычисляемые колонки, правила проблем, счётчики на разделах меню, действия с фиксированным патчем, запросы метрик и команды в подах описаны данными. Их считает сам Sextant, код расширения при этом не запускается. В 32 расширениях команды так описаны 196 видов, 736 колонок и 354 правила.
Страницы. Секции деталей, страницы и диалоги — это iframe в песочнице без сети, которые говорят с Sextant только JSON-сообщениями. Их 103.
Бэкенд. Компонент WebAssembly в wasmtime без файлов и окружения. Он нужен там, где декларации мало: инструменты для AI-агентов, сложные проверки конфигурации, сервисы вроде API Argo CD. Бэкенд есть только у четырёх из 32: Flux, Argo CD, Argo Rollouts и Service mesh.
Почему декларации, а не код:
- Скорость. Колонку таблицы на 20 тысяч объектов считает хост, а не гоняет каждую строку через postMessage.
- Работа в фоне. Правила проблем и уведомления работают, когда ни одна страница расширения не открыта, и чужой код для этого не держится живым.
- Прозрачность. Окно согласия показывает ровно то, что расширение будет читать и менять: виды, запросы PromQL слово в слово, аргументы команд.
- Один страж. Все три слоя идут в кластер через одну проверку прав в Rust, ту же, что у AI-агентов.
Вот как выглядит вычисляемая колонка и правило проблемы в манифесте, сокращённо:
"columns": [{
"kind": { "group": "postgresql.cnpg.io", "kind": "Cluster" },
"id": "cluster-status", "title": "Status",
"paths": [".status.phase"],
"cases": [{
"when": { "type": "equals", "path": ".metadata.annotations[\"cnpg.io/hibernation\"]", "value": "on" },
"text": "Hibernated", "tone": "muted"
}]
}],
"problems": [{
"id": "last-backup-failed", "title": "Last backup failed",
"kind": { "group": "postgresql.cnpg.io", "kind": "Cluster" },
"when": { "type": "all", "of": [
{ "type": "absent", "path": ".metadata.deletionTimestamp" },
{ "type": "condition", "conditionType": "LastBackupSucceeded", "status": "False" }
]}
}]Совместимость: API только растёт
Чтобы вынести встроенные интеграции без потери функций, API пришлось сильно расширить. Версия указывается в манифесте полем sextantApi:
API
Sextant
Что добавилось
5
0.30.1
проблемы в ячейках, связи между объектами, маскированные секреты — всё, чего не хватало для полного совпадения со встроенными видами
4
0.30.0
свои виды в таблицах, вычисляемые колонки, сервисы и вход, инструменты для AI-агентов, судьи проблем в бэкенде
3
0.29
счётчики на разделах, правила по нескольким объектам, команды в подах
2
0.28
правила проблем, запросы метрик, переводы
1
0.6
страницы, секции, действия, колонки; с 0.26 — бэкенд на WebAssembly
При этом из API ничего не удаляется и не меняет смысла. Расширение, собранное для первой версии API, ставится и работает в 0.30. Это не обещание, а тест: в репозитории лежат замороженные пакеты прошлых версий со вшитым старым SDK. На каждом изменении их запускают против настоящего протокола, прав и среды выполнения бэкенда.
Работает и в другую сторону. Если свежая версия расширения требует API, которого у вашего Sextant нет, каталог предложит последний релиз, который ваша версия сможет запустить.
SDK
SDK лежит в репозитории Sextant, в папке sdk/, и проверяется вместе с приложением (781 тест). В нём:
- типы манифеста и API, сгенерированные из Rust;
- клиент для страницы и UI-кит с блоками, таблицами и статусами в стиле Sextant, в обеих темах;
- переводы с множественными формами CLDR для 14 языков Sextant;
- бэкенд на TypeScript (defineBackend) или Rust;
- тестовый хост, чтобы тестировать страницы без Sextant;
- сборку, упаковку и подпись minisign для каталога.
Манифест SDK проверяет по тем же правилам, что и Rust: у двух реализаций общий файл тестовых случаев. Ошибка в манифесте всплывает при сборке, а не у пользователя.
Секция в деталях объекта выглядит так:
import { connect, ui } from "@sextant/extension-sdk";
const sextant = await connect(); // тема и язык Sextant
const ref = sextant.context.selection[0]; // объект открытых деталей
const cluster = await sextant.resources.get({ ref }); // через стража, с правами расширения
document.body.append(
ui.block("PostgreSQL", ui.fields([
["Instances", cluster.status?.readyInstances],
["Phase", ui.status(cluster.status?.phase ?? "—", "success")],
])),
);Лучшие примеры — сами 32 расширения из папки extensions/. У каждого есть README по одной схеме: что оно добавляет, какие права просит и почему, какие правила проблем и команды в нём есть.
Ссылки
- Sextant и релизы: github.com/FriendsOfKubernetes/sextant
- Каталог расширений: FriendsOfKubernetes/sextant-extensions
- Как написать расширение: Writing extensions
- Расширения команды Sextant: extensions/
- Решения и их причины: docs/adr
Если для вашего оператора в API чего-то не хватает, напишите в issues. Каждая версия API со 2 по 5 выросла из списка того, чего не хватало конкретным расширениям.
Комментарии
Обсуждайте статью, отвечайте и оценивайте комментарии. Вход — через ваш Яндекс ID.
Загружаем обсуждение…