OpenBao — сервер управления секретами для Kubernetes
Этот пример компилирует небольшой реальный стек — единственный сервер секретов OpenBao —
из одного написанного разработчиком Aggregate в Kubernetes с опорой на
официальный Helm-чарт OpenBao.
OpenBao хранит, генерирует токены, пароли, сертификаты и другие секреты и управляет доступом к ним через аутентифицированный HTTP API, а также шифрует своё состояние при хранении на постоянном томе данных. Здесь он работает как один автономный сервер, который хранит состояние во встроенном файловом бэкенде хранения, поэтому он формируется как работающий сервер с состоянием на постоянном томе, а не как ресурс управляемого облака. Сервер инициализируется и распечатывается во время выполнения внутри кластера — его корневой токен и ключи распечатывания создаёт работающий сервер после запуска, — поэтому в Aggregate не объявляется никаких учётных данных и никакой секрет не материализуется во время сборки.
Файлы
| Файл | Роль |
|---|---|
aggregate.yaml | Намерение разработчика: единственный компонент secrets (core/security/openbao) с включённым встроенным веб-интерфейсом. |
manifest.yaml | Сопоставляет тип компонента с официальным подключаемым Recipe (openbao). |
release.yaml | Запись оператора для целевой платформы Kubernetes: вычислительные ресурсы сервера и размер тома данных. |
Что демонстрирует пример
- Одна поверхность для написания. Единственный Aggregate — источник истины о том, что представляет собой сервер секретов; Manifest говорит, как его реализовать.
- Значение разработчика доходит до результата. Значение разработчика
ui_enabledзаписывается в конфигурацию сервера, которую монтирует чарт, и управляет включением встроенного веб-интерфейса. - Сервер с состоянием на постоянном томе. Подключаемый Recipe
настраивает автономный режим с файловым бэкендом хранения, поэтому сервер хранит
зашифрованное состояние на
PersistentVolumeClaim, смонтированном в/openbao/data, размер которого задаётstorage.sizeоператора. - Никаких учётных данных при формировании. OpenBao инициализирует и распечатывает себя во
время выполнения, поэтому сборка не подключает учётных данных и не создаёт
Secret. Сформированный результат побайтно идентичен между запусками с одинаковыми входными данными. - Воспроизводимый образ. Recipe закрепляет образ сервера за разрешимым тегом выпуска (
quay.io/openbao/openbao:2.5.5), поэтому сформированная рабочая нагрузка ссылается на закреплённую версию.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example openbao-secretsЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd openbao-secretsСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:
aggrega pull --release release.yamlaggrega build --release release.yamlСформированные артефакты помещаются в dist/. Сборка разрешает вышестоящий чарт по
ссылке OCI при aggrega pull и закрепляет его в lock-файле.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке Workspace ещё нет папки `openbao-secrets`, вызовите один раз инструмент `scaffold`, задав для `example` значение `openbao-secrets` и не задавая `dir`: он запишет пример в новую папку `openbao-secrets`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `openbao-secrets`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите мне, какие файлы записала сборка; они находятся в `openbao-secrets/dist/`.Что формируется
Сборка создаёт компактный стек OpenBao с одной рабочей нагрузкой в виде семи объектов Kubernetes:
StatefulSetдля сервера OpenBao,ConfigMapс конфигурацией сервера (файловый бэкенд хранения и слушатель API),- два объекта
Service— основной сервис API и внутренний headless-сервис, который StatefulSet использует для стабильной сетевой адресации подов, ServiceAccountдля пода сервера,ClusterRoleBinding, предоставляющий серверу право проверки токенов, которое он использует для аутентификации сервисных учётных записей Kubernetes,Podсhelm.sh/hook: test, проверяющий готовность сервера.
Объектов CustomResourceDefinition нет — OpenBao является самодостаточным сервером, а не контроллером, расширяющим API кластера. Образ сервера закреплён за его тегом выпуска, поэтому рабочая нагрузка ссылается на закреплённый тег образа.