Memcached — один Aggregate, дві цілі та відхилений пароль
Цей мінімальний приклад компілює єдиний кеш у пам’яті Memcached з одного написаного розробником Aggregate у дві реалізації:
- Docker Compose для локальної розробки та
- синтезований helm Recipe, що запускає офіційний upstream-образ
memcachedбезпосередньо в Kubernetes (без зовнішнього чарту).
Синтезований helm Recipe — бажаний шлях для Kubernetes: він залежить лише від тегу офіційного образу, а не від стороннього чарту, і набір відрендерених ресурсів точно відповідає тому, що оголошує робоче навантаження.
Обидві керуються тим самим aggregate.yaml. Для кожної реалізації змінюється лише шар Recipe, вибраний сутністю Manifest. Ще дві сутності Aggregate приєднують до кешу пароль, а їхні сутності Releases — негативні приклади: збірка зупиняється, бо жодна реалізація не може забезпечити пароль Memcached.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент cache типу core/datastore/memcached, без облікових даних — кеш працює без автентифікації. |
aggregate-auth.yaml | Той самий кеш із паролем типу inject-value, приєднаним до необов’язкового слота password компонента (шлях Compose). Його збірка зупиняється. |
aggregate-helm-synth-auth.yaml | Той самий кеш із паролем, на який можна посилатися, приєднаним для шляху синтезованого helm. Його збірка зупиняється. |
manifest-compose.yaml | Зіставляє тип Memcached із Compose Recipe (compose/memcached), а облікові дані — з dotenv-secret. |
manifest-helm-synth.yaml | Зіставляє тип Memcached із синтезованим helm Recipe (helm/memcached), а облікові дані — з k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Записи оператора для двох реалізацій. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Записи оператора поверх двох сутностей Aggregate з паролем. Очікується, що кожна збірка завершиться невдачею. |
Що демонструє приклад
- Одна поверхня написання, багато цілей. Єдиний Aggregate є джерелом істини щодо того, що являє собою стек. Кожен Manifest визначає, як його реалізувати.
- Сховище даних без стану. Memcached тримає записи в пам’яті й нічого не зберігає
постійно, тому компонент має тип простого
server, а неstateful-server. У Kubernetes Recipe рендерить Deployment, а не StatefulSet, і не запитує постійного тому; у Compose сервіс не оголошує тому даних. - Синтез робочого навантаження (Kubernetes). Синтезований helm Recipe оголошує Workload — Deployment і ClusterIP Service з офіційним образом
memcached, — який helm-провайдер перетворює на маніфести Kubernetes без зовнішнього чарту. Набір відрендерених ресурсів точно відповідає тому, що оголошує Workload. Оскільки і Compose Recipe, і синтезований helm Recipe мають назвуmemcached, Manifests посилаються на них з областю провайдера якcompose/memcachedіhelm/memcached. - Захист, який реалізація не може надати, відхиляється, а не відкидається мовчки. Компонент оголошує необов’язковий слот
password. Образmemcachedне забезпечує жодного пароля: два його режими автентифікації — це SASL, що працює лише через бінарний протокол, і файл автентифікації ASCII, а клієнти Memcached із каталогу не використовують жодного з них. Recipe, що прийняла б вкладення, відрендерила б кеш, який відповідає кожному клієнту, тоді як Aggregate стверджує, що він захищений, тож кожна Recipe натомість зупиняє збірку, називаючи слот.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example memcached-cacheПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd memcached-cacheЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)aggrega build --release release-helm-synth.yaml --auto-pullВідрендерені артефакти потрапляють у dist/.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `memcached-cache`, викличте один раз інструмент `scaffold`, задавши для `example` значення `memcached-cache`, без `dir`: він запише приклад у нову теку `memcached-cache`. Потім викличте інструмент `build` один раз для кожного файлу Release у такому порядку — `release-compose.yaml` і `release-helm-synth.yaml` — щоразу задаючи для `workspace_root` значення `memcached-cache`, для `release` — цей файл, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала кожна збірка; вони розташовані в `memcached-cache/dist/`.Контрольний випадок: пароль, який кеш не може забезпечити
Дві негативні сутності Release збирають сутності Aggregate з паролем, і очікується, що кожна збірка завершиться невдачею:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullКожна зупиняється в Recipe для Memcached ще до того, як щось записано, і зупинка завершується власним повідомленням Recipe:
a password is attached to the password slot of "cache", but the memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkВідмова прив’язана до самого вкладення, а не до того, як доставляються облікові дані, тож кожна сутність Feature, що може заповнити слот, зупиняється однаково. Керовані реалізації поводяться так само: Amazon ElastiCache не пропонує автентифікації Memcached, і її сутності Recipes теж зупиняються на вкладенні. Тож кеш Memcached захищає те, хто може до нього дістатися, — мережа, у якій його розміщено, — а збирати слід базовий aggregate.yaml.