Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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), поэтому сформированная рабочая нагрузка ссылается на закреплённую версию.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example openbao-secrets

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd openbao-secrets

Сборка

В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:

Terminal window
aggrega pull --release release.yaml
aggrega 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 кластера. Образ сервера закреплён за его тегом выпуска, поэтому рабочая нагрузка ссылается на закреплённый тег образа.