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