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