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), тож відрендерене робоче навантаження посилається на зафіксовану версію.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example sealed-secrets-controllerПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd sealed-secrets-controllerЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:
aggrega pull --release release.yamlaggrega 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— сервіс контролера та його сервіс метрик.
Образ контролера зафіксовано на його тегу релізу, тож робоче навантаження посилається на зафіксований тег образу.