コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

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.yamlDeveloper の意図:型が core/datastore/memcached の cache コンポーネントが 1 つ、資格情報なし — キャッシュは認証なしで動作します。
aggregate-auth.yaml同じキャッシュに、コンポーネントのオプションの password スロットへ inject-value のパスワード資格情報を付与したもの(Compose の経路)。そのビルドは停止します。
aggregate-helm-synth-auth.yaml同じキャッシュに、合成 helm の経路向けに参照可能なパスワード資格情報を付与したもの。そのビルドは停止します。
manifest-compose.yamlMemcached の型を Compose の Recipe(compose/memcached)に、資格情報を dotenv-secret にマッピングします。
manifest-helm-synth.yamlMemcached の型を合成された helm Recipe(helm/memcached)に、資格情報を k8s-secret-from-parameter にマッピングします。
release-compose.yaml / release-helm-synth.yaml2 つの実現形態のためのオペレーターレコード。
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 アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example memcached-cache

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd memcached-cache

ビルド

このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き込みます。

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/ 配下に出力されます。

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 をビルドし、どちらのビルドも失敗することが想定されています:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega 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 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 です。