Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Memcached — один Aggregate, две целевые платформы и отклонённый пароль

Этот компактный пример компилирует единственный кеш в памяти Memcached из одного написанного разработчиком Aggregate в две реализации:

  • Docker Compose для локальной разработки и
  • синтезированный helm Recipe, запускающий официальный образ 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.