Memcached — 1 つの Aggregate、2 つのターゲット、そして拒否されるパスワード
この簡潔な例では、Developer が作成した 1 つの Aggregate から、単一の Memcached インメモリキャッシュを 2 つの実現形態にコンパイルします:
- ローカル開発向けの Docker Compose、そして
- 公式のアップストリーム
memcachedイメージを Kubernetes 上で直接実行する 合成された helm Recipe(外部チャートなし)。
合成された helm Recipe は、推奨される Kubernetes の経路です。サードパーティのチャートではなく 公式イメージのタグのみに依存し、レンダリングされるリソースセットは workload が宣言する内容とまったく同じです。
同じ aggregate.yaml が両方を駆動します。実現形態ごとに変わるのは、Manifest が選択する Recipe レイヤーだけです。さらに 2 つの Aggregate がキャッシュにパスワードをアタッチしており、それらの Releases は失敗例です。どの実現形態も Memcached のパスワードを強制できないため、ビルドは停止します。
ファイル
| ファイル | 役割 |
|---|---|
aggregate.yaml | Developer の意図:型が core/datastore/memcached の cache コンポーネントが 1 つ、資格情報なし — キャッシュは認証なしで動作します。 |
aggregate-auth.yaml | 同じキャッシュに、コンポーネントのオプションの password スロットへ inject-value のパスワード資格情報を付与したもの(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 | 2 つの実現形態のためのオペレーターレコード。 |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | パスワード付きの 2 つの Aggregate に対するオペレーターの記録です。どちらのビルドも失敗することが想定されています。 |
示す内容
- 1 つの作成インターフェース、多数のターゲット。 1 つの Aggregate が、スタックが 何 であるかの信頼できる唯一の情報源です。各 Manifest は、それを どのように 実現するかを記述します。
- ステートレスなデータストア。 Memcached はエントリをメモリに保持し、何も永続的には
保存しないため、コンポーネントの型は
stateful-serverではなく単純なserverです。 Kubernetes 上では Recipe は StatefulSet ではなく Deployment をレンダリングし、 永続ボリュームを要求しません。Compose 上では、サービスはデータボリュームを宣言しません。 - Workload の合成(Kubernetes)。 合成された helm Recipe は、Workload — 公式の
memcachedイメージを実行する Deployment と ClusterIP Service — を宣言し、helm provider がそれを外部チャートなしで Kubernetes マニフェストに変換します。レンダリングされるリソースセットは、Workload が宣言する内容とまったく同じです。Compose の Recipe と合成された helm Recipe の両方がmemcachedという名前を持つため、Manifests はそれらを provider スコープ付きでcompose/memcachedとhelm/memcachedとして参照します。 - 実現形態が提供できない保護は、無視されるのではなく拒否されます。 コンポーネントはオプションの
passwordスロットを宣言しています。memcachedイメージはパスワードを強制しません。その 2 つの認証モードは、バイナリプロトコルでのみ使われる SASL と ASCII 認証ファイルであり、カタログの Memcached クライアントはどちらも使いません。アタッチメントを受け入れる Recipe は、Aggregate が保護されていると述べているのに、あらゆるクライアントに応答するキャッシュをレンダリングすることになります。そのため、各 Recipe は代わりにスロットを示してビルドを停止します。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example memcached-cacheその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd memcached-cacheビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き込みます。
# 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/ 配下に出力されます。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `memcached-cache` フォルダーがない場合は、`example` を `memcached-cache` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `memcached-cache` フォルダーに書き込まれます。次に、`release-compose.yaml`、`release-helm-synth.yaml` の順に、各 Release について `build` ツールを一度ずつ呼び出してください。毎回、`workspace_root` を `memcached-cache`、`release` をそのファイル、`auto_pull` を true、`write` を true に設定します。各ビルドが書き込んだファイルを教えてください。ファイルは `memcached-cache/dist/` の下にあります。対照: キャッシュが強制できないパスワード
2 つの失敗例の Release はパスワード付きの Aggregate をビルドし、どちらのビルドも失敗することが想定されています:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullどちらも何かが書き出される前に Memcached の Recipe で停止し、停止は 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 です。