external-secrets — оператор Kubernetes для синхронизации секретов
Этот пример компилирует небольшой реальный стек — оператор external-secrets —
из одной сущности Aggregate, написанной разработчиком, в Kubernetes на основе официального
Helm-чарта external-secrets.
external-secrets синхронизирует секретные данные из внешних систем управления секретами —
HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key
Vault и других — в нативные Kubernetes Secrets и поддерживает их актуальность при
изменении источника. Это контроллер уровня кластера, который расширяет API кластера
собственными пользовательскими ресурсами, а не сервер, к которому обращаются приложения, поэтому
он не принимает ребро uses, а публикует лишь адрес, по которому сервер Prometheus находит
его метрики: приложения получают свои секреты, объявляя ресурсы ExternalSecret и
SecretStore, а оператор создаёт соответствующие
объекты Kubernetes Secret.
Файлы
| Файл | Роль |
|---|---|
aggregate.yaml | Намерение разработчика: единственный компонент external-secrets (core/security/external-secrets), устанавливающий определения пользовательских ресурсов вместе с релизом. |
manifest.yaml | Сопоставляет тип компонента с официальной внешней сущностью Recipe (external-secrets). |
release.yaml | Запись оператора для целевой платформы Kubernetes: вычислительные ресурсы оператора. |
Что демонстрирует пример
- Одна поверхность описания. Единственная сущность Aggregate — источник истины о том, что представляет собой оператор; сущность Manifest описывает, как его реализовать.
- Значение разработчика доходит до рендеринга. Значение разработчика
install_crdsзаписывается в значение чартаinstallCRDs, благодаря чему определения пользовательских ресурсов external-secrets попадают в кластер вместе с релизом. - Контроллер, расширяющий кластер, без ребра топологии. external-secrets добавляет
собственные пользовательские ресурсы в API кластера; потребители запрашивают секреты,
объявляя эти ресурсы, поэтому компонент не создаёт ребро
usesи экспортирует только адрес своих метрик. - Единый целостный оператор. Чарт рендерит контроллер, вебхук и контроллер сертификатов как один оператор; встроенный сабчарт провайдеров отключён, поэтому посторонние хранилища данных, кэши и брокеры не подтягиваются. Результат рендеринга побайтно идентичен между запусками на одних и тех же входных данных.
- Воспроизводимый образ. Сущность Recipe фиксирует все три образа контейнеров на разрешимом теге релиза (
ghcr.io/external-secrets/external-secrets:v2.7.0), поэтому отрендеренные рабочие нагрузки ссылаются на зафиксированную версию.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example external-secrets-operatorЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd external-secrets-operatorСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:
aggrega pull --release release.yamlaggrega build --release release.yamlСформированные артефакты помещаются в dist/. Сборка разрешает вышестоящий чарт по
ссылке OCI при aggrega pull и закрепляет его в lock-файле.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочей области ещё нет папки `external-secrets-operator`, вызовите инструмент `scaffold` один раз, задав `example` равным `external-secrets-operator` и не указывая `dir`: он запишет пример в новую папку `external-secrets-operator`. Затем вызовите инструмент `build`, задав `workspace_root` равным `external-secrets-operator`, `release` равным `release.yaml`, `auto_pull` равным true и `write` равным true. Сообщите мне, какие файлы записала сборка; они находятся в `external-secrets-operator/dist/`.Что формируется
Сборка выводит оператор external-secrets в виде набора объектов Kubernetes:
- 24 объекта
CustomResourceDefinitionдля API external-secrets (ExternalSecret,SecretStore,ClusterSecretStoreи связанные ресурсы push и генераторов), - три объекта
Deployment— контроллер, вебхук и контроллер сертификатов, - связывающие их правила RBAC: объекты
ClusterRole,ClusterRoleBinding, одинRoleи одинRoleBinding, - три объекта
ServiceAccount, по одному на рабочую нагрузку, - объект
Serviceдля вебхука, - два объекта
ValidatingWebhookConfiguration, - объект-заглушка
Secret, который контроллер сертификатов во время выполнения заполняет сертификатом, обслуживающим вебхук.
Все три образа контейнеров зафиксированы на теге релиза, поэтому рабочие нагрузки ссылаются на зафиксированные образы.