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

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

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

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

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

Terminal window
aggrega scaffold --example external-secrets-operator

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd external-secrets-operator

Сборка

В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:

Terminal window
aggrega pull --release release.yaml
aggrega 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, который контроллер сертификатов во время выполнения заполняет сертификатом, обслуживающим вебхук.

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