Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

MariaDB у Kubernetes — синтезований helm (StatefulSet), облікові дані з двома слотами

Єдина база даних MariaDB, відрендерена в Kubernetes синтезом Workload провайдера helm — без зовнішнього чарту. Сутність core/datastore/mariadb Component прив’язується до сутності helm/mariadb Recipe, яка оголошує Workload form: stateful; провайдер helm перетворює її на StatefulSet, ClusterIP Service, Headless Service (стабільну мережеву ідентичність StatefulSet) і volumeClaimTemplate для каталогу даних.

Мета прикладу — модель облікових даних із двома слотами MariaDB на синтезованій цілі helm. Два слоти паролів доставляються різними механізмами, бо Component оголошує їх по-різному, а Recipe під’єднує кожен так, як того вимагає його слот.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example mariadb-helm-synth

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd mariadb-helm-synth

Збирання

Terminal window
aggrega build --release release.yaml --auto-pull

Каталог розв’язується з реєстру hub, указаного в .aggrega-config.yaml, тож прапорець --catalog не потрібен, а --auto-pull під час збирання записує lockfile, якого бракує свіжому клону. Чотири маніфести з’являються в dist/helm/helm/.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `mariadb-helm-synth`, викличте один раз інструмент `scaffold`, задавши для `example` значення `mariadb-helm-synth`, без `dir`: він запише приклад у нову теку `mariadb-helm-synth`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `mariadb-helm-synth`, для `release` — `release.yaml`, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала збірка; вони розташовані в `mariadb-helm-synth/dist/`.

root_password — Black-Box, доставляється каналом inject

root_password — це слот Black-Box: featuresSchema сутності Component оголошує inject: [], тож доставкою керує Recipe, і розробник не може її визначати. Aggregate під’єднує core/secret-value, яку Manifest зіставляє з env-secret. Ця FeatureRecipe розміщує значення в каналі inject компонента під вибраним ключем, а Recipe зчитує його як .context.inject.env.MARIADB_ROOT_PASSWORD, видаючи звичайну змінну середовища контейнера:

# db-statefulset.yaml (container env)
- name: MARIADB_ROOT_PASSWORD
value: dev-root-pw-change-me

На слот Black-Box ніколи не посилаються з блоку attachments: контейнера робочого навантаження, і для нього не генерується жоден ресурс Kubernetes Secret — значення потрапляє в контейнер безпосередньо через канал inject.

user_password — прозорий, доставляється як Secret + secretKeyRef

user_password — це прозорий слот (inject: [env, file]). Aggregate під’єднує core/referenced-secret, яку Manifest зіставляє з k8s-secret-from-parameter. Ця FeatureRecipe створює Kubernetes Secret і публікує ідентичність цього Secret як provides {name, key}. Recipe посилається на слот через containers.attachments, що синтезатор рендерить як secretKeyRef змінної середовища. Згенерований Secret і посилання контейнера називають той самий ресурс, бо обидва зчитують .features.user_password.provides.name — немає ні повторного виведення, ні домовленості, щодо якої дві сторони мали б погодитися. Опубліковане ім’я замінює підкреслення в імені слоту дефісами, тож user_password стає коректним іменем ресурсу Kubernetes db-user-password. Ім’я файлу, що його містить, виводиться окремо й виглядає інакше: воно додає як префікс компонент та ім’я слоту як власні координати вкладення, закодовані для алфавіту імен файлів, що допускає лише малі літери й цифри, тож підкреслення там з’являється як екранування, а не як дефіс.

db--user-zupassword--db-secret-db-user-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-user-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)
- name: MARIADB_PASSWORD
valueFrom:
secretKeyRef:
name: db-user-password # == the Secret's metadata.name
key: MARIADB_PASSWORD # == the Secret's data key

Залишити user_password не під’єднаним теж допустимо: Recipe повертається до вбудованого значення за замовчуванням для розробки (MARIADB_PASSWORD: apppass), і Secret не генерується, тож мінімальне розгортання все одно рендериться й працює.

Визначення розмірів оператором

release.yaml реалізує принцип визначення розмірів оператором для кожного середовища: тег образу контейнера береться з infra.engine_version (mariadb:11.4), а запит і клас сховища volumeClaimTemplate — з infra.storage (5Gi, standard). Aggregate розробника ніколи не містить цих полів.