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

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 натомість зупиняє збірку, називаючи слот.

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

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

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

Terminal window
aggrega scaffold --example memcached-cache

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

Terminal window
cd memcached-cache

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:

Terminal window
# 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 з паролем, і очікується, що кожна збірка завершиться невдачею:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega 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 memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

Відмова прив’язана до самого вкладення, а не до того, як доставляються облікові дані, тож кожна сутність Feature, що може заповнити слот, зупиняється однаково. Керовані реалізації поводяться так само: Amazon ElastiCache не пропонує автентифікації Memcached, і її сутності Recipes теж зупиняються на вкладенні. Тож кеш Memcached захищає те, хто може до нього дістатися, — мережа, у якій його розміщено, — а збирати слід базовий aggregate.yaml.