Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

sealed-secrets — контролер розшифрування Kubernetes SealedSecret

Цей приклад компілює невеликий реальний стек — контролер sealed-secrets — з одного Aggregate, написаного розробником, у Kubernetes, спираючись на офіційний Helm-чарт sealed-secrets, що роздається з репозиторію чартів через HTTPS.

sealed-secrets дає змогу безпечно зберігати зашифровані секрети в системі керування версіями: відкритий ключ шифрує секрет у користувацький ресурс SealedSecret, а контролер рівня кластера, що має відповідний закритий ключ, розшифровує його назад у нативний Kubernetes Secret. Контролер розширює API кластера власним користувацьким ресурсом SealedSecret, а не є сервером, до якого звертаються застосунки, тому він не має ребра uses і нічого не експортує споживачам: застосунки отримують свої секрети, оголошуючи ресурси SealedSecret, а контролер розпечатує відповідні Kubernetes-ресурси Secret. Контролер генерує свою пару ключів для запечатування в кластері під час виконання, тож жодний ключовий матеріал не створюється під час рендерингу.

Файли

ФайлРоль
aggregate.yamlНамір розробника: єдиний компонент sealed-secrets (core/security/sealed-secrets).
manifest.yamlЗіставляє тип компонента з офіційним зовнішнім Recipe (sealed-secrets).
release.yamlЗапис оператора для цілі Kubernetes: обчислювальні ресурси оператора.

Що демонструє приклад

  • Одна поверхня авторингу. Єдиний Aggregate є джерелом істини щодо того, чим є контролер; Manifest визначає, як його реалізувати.
  • Чарт, що роздається через HTTPS. Recipe отримує чарт із репозиторію чартів через HTTPS, а не з реєстру OCI; збирання розв’язує та фіксує його під час aggrega pull.
  • CRD, що постачається в каталозі CRD чарту. CustomResourceDefinition SealedSecret міститься в нативному для Helm каталозі CRD чарту, а не в шаблонах; він рендериться у вивід разом із релізом безумовно.
  • Контролер, що розширює кластер, без ребра топології. sealed-secrets додає власний користувацький ресурс до API кластера; споживачі запитують секрети, оголошуючи ресурси SealedSecret, тому компонент не з’єднується ребром uses і нічого не експортує.
  • Єдиний цілісний контролер. Чарт рендерить один контролер із його RBAC і сервісами, без стороннього сховища даних, кешу чи брокера. Відрендерений вивід побайтово ідентичний між запусками з тими самими вхідними даними.
  • Відтворюваний образ. Recipe фіксує образ контролера на розв’язуваному тегу релізу (docker.io/bitnami/sealed-secrets-controller:0.38.4), тож відрендерене робоче навантаження посилається на зафіксовану версію.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example sealed-secrets-controller

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd sealed-secrets-controller

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Відрендерені артефакти потрапляють у dist/. Збирання розв’язує вихідний чарт із репозиторію чартів через HTTPS під час aggrega pull і фіксує його у lock-файлі.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної папки самостійно. Якщо папка робочої області ще не містить папки `sealed-secrets-controller`, викличте один раз інструмент `scaffold` з параметром `example` зі значенням `sealed-secrets-controller` і без `dir`: він запише приклад у нову папку `sealed-secrets-controller`. Потім викличте інструмент `build` з параметрами `workspace_root` — `sealed-secrets-controller`, `release` — `release.yaml`, `auto_pull` — true і `write` — true. Скажіть мені, які файли записала збірка; вони розташовані в `sealed-secrets-controller/dist/`.

Що рендериться

Збирання видає контролер sealed-secrets як набір об’єктів Kubernetes:

  • один CustomResourceDefinition для API sealed-secrets (SealedSecret),
  • один Deployment — контролер,
  • RBAC, що його прив’язує: ClusterRole, ClusterRoleBinding, два об’єкти Role і два об’єкти RoleBinding,
  • один ServiceAccount,
  • два об’єкти Service — сервіс контролера та його сервіс метрик.

Образ контролера зафіксовано на його тегу релізу, тож робоче навантаження посилається на зафіксований тег образу.