Перейти до вмісту
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, який контролер сертифікатів під час виконання заповнює сертифікатом, що його обслуговує вебхук.

Усі три образи контейнерів зафіксовано на тезі релізу, тому робочі навантаження посилаються на зафіксовані образи.