Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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), поэтому сформированная рабочая нагрузка ссылается на зафиксированную версию.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

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 — сервис контроллера и его сервис метрик.

Образ контроллера зафиксирован на теге релиза, поэтому рабочая нагрузка ссылается на зафиксированный тег образа.