sealed-secrets — контроллер расшифровки Kubernetes SealedSecret
Этот пример компилирует небольшой реальный стек — контроллер sealed-secrets —
из одного Aggregate, написанного разработчиком, в Kubernetes на основе официального
Helm-чарта sealed-secrets, раздаваемого из репозитория чартов по HTTPS.
sealed-secrets позволяет безопасно фиксировать зашифрованные секреты в системе контроля версий:
открытый ключ шифрует секрет в пользовательский ресурс SealedSecret,
а контроллер уровня кластера, владеющий соответствующим закрытым ключом, расшифровывает его
обратно в нативный Secret Kubernetes. Контроллер расширяет API кластера
собственным пользовательским ресурсом SealedSecret, а не является сервером,
к которому обращаются приложения, поэтому у него нет ребра uses и он ничего не экспортирует
потребителям: приложения получают свои секреты, объявляя ресурсы SealedSecret,
а контроллер распечатывает соответствующие объекты Secret Kubernetes.
Контроллер генерирует свою пару ключей для запечатывания в кластере во время выполнения, поэтому
при рендеринге ключевой материал не создаётся.
Файлы
| Файл | Роль |
|---|---|
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— сервис контроллера и его сервис метрик.
Образ контроллера зафиксирован на теге релиза, поэтому рабочая нагрузка ссылается на зафиксированный тег образа.