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 під’єднує кожен так, як того вимагає його слот.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example mariadb-helm-synthПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd mariadb-helm-synthЗбирання
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. Ім’я файлу, що
його містить, виводиться окремо й виглядає інакше: воно додає як префікс
компонент та ім’я слоту як власні координати вкладення, закодовані для
алфавіту імен файлів, що допускає лише малі літери й цифри, тож
підкреслення там з’являється як екранування, а не як дефіс.
[… 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 розробника ніколи не містить цих полів.