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 кластера. Образ сервера зафіксовано на його тезі релізу, тож робоче навантаження посилається на зафіксований тег образу.