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

Valkey — 1 つの Aggregate、2 つのターゲット、オプションの認証

この簡潔な例では、Developer が作成した 1 つの Aggregate から、単一の Valkey インメモリキャッシュ(Redis ワイヤープロトコル)を 2 つの実現形態へコンパイルします:

  • ローカル開発向けの Docker Compose、そして
  • 公式のアップストリーム valkey/valkey イメージを Kubernetes 上で直接実行する 合成 helm Recipe(外部チャートなし)。

合成 helm Recipe は Kubernetes 向けの経路です。サードパーティのチャートではなく 公式イメージタグのみに依存し、レンダリングされるリソースセットは ワークロードが宣言する内容とまったく同じです。

同じ aggregate.yaml が両方を駆動します。実現形態ごとに変わるのは、Manifest が選択する Recipe 層だけです。さらに 2 つの Aggregates が、オプションのパスワード資格情報を付与した同じキャッシュを示します。aggregate-auth.yaml は Compose 経路向け(サーバーの起動に使われる inject-value 資格情報)、aggregate-helm-synth-auth.yaml は合成 helm 経路向け(Kubernetes Secret として具現化される参照可能な資格情報)です。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:型 core/datastore/valkey の cache コンポーネントを 1 つ、資格情報なし — キャッシュは認証なしで実行されます。
aggregate-auth.yamlコンポーネントのオプションの password スロットにパスワード資格情報を付与した同じキャッシュ(Compose 経路)。
aggregate-helm-synth-auth.yaml同じキャッシュに、合成された helm の経路向けに参照可能な資格情報を付与したもの — 値は Deployment が参照する Kubernetes Secret として具現化されます。
manifest-compose.yamlValkey 型を Compose Recipe(compose/valkey)に、資格情報を dotenv-secret にマッピングします。
manifest-helm-synth.yamlValkey 型を合成 helm Recipe(helm/valkey)に、資格情報を k8s-secret-from-parameter にマッピングします。
release-compose.yaml / release-helm-synth.yaml2 つの実現形態向けの Operator レコード、認証なし。
release-compose-auth.yaml / release-helm-synth-auth.yaml認証を有効にする Operator レコード。

示す内容

  • 1 つの作成インターフェース、多数のターゲット。 1 つの Aggregate が、スタックが 何 であるかの信頼できる唯一の情報源です。各 Manifest は、それを どのように 実現するかを記述します。
  • キャッシュ役のデータストア。 ここでは Valkey をインメモリキャッシュとして使用し、 何も永続的に保存しないため、コンポーネントは stateful-server ではなく 単純な server として型付けされます。Kubernetes では合成 helm Recipe が StatefulSet ではなく Deployment をレンダリングし、永続ボリュームを要求しません。 Compose ではサービスはデータボリュームを宣言しません。
  • Workload の合成(Kubernetes)。 合成 helm Recipe は Workload — 公式の valkey/valkey イメージを実行する Deployment と ClusterIP Service — を宣言し、 helm プロバイダーがそれを外部チャートなしで Kubernetes マニフェストに変換します。 レンダリングされるリソースセットは Workload が宣言する内容とまったく同じです。 Compose Recipe と合成 helm Recipe の両方が valkey という名前を持つため、 Manifests はそれらをプロバイダースコープ付きで compose/valkey および helm/valkey として参照します。
  • 資格情報スロットによるオプションの認証。 コンポーネントは featuresSchema にオプションの password スロットを 1 つ宣言します。資格情報が付与されていない場合(ベースの Aggregate)、Recipe は認証を無効にした状態でキャッシュをレンダリングします — スロットのない Recipe とバイト単位で同一です。資格情報が付与されると、両方のターゲットが --requirepass 付きで Valkey を起動するため、サーバーはパスワードを要求します。Compose では値がイメージの VALKEY_EXTRA_FLAGS 変数を通じてサーバーに届き、Kubernetes では合成 helm 経路がそれを Deployment が参照する Secret として具現化します。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

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

Terminal window
aggrega scaffold --example valkey-cache

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

Terminal window
cd valkey-cache

ビルド

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

Terminal window
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

レンダリングされた成果物は dist/ 配下に出力されます。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `valkey-cache` フォルダーがない場合は、`example` を `valkey-cache` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `valkey-cache` フォルダーに例が書き込まれます。次に、Release ごとに 1 回ずつ、`release-compose.yaml`、`release-helm-synth.yaml`、`release-compose-auth.yaml`、`release-helm-synth-auth.yaml` の順で `build` ツールを呼び出してください。毎回 `workspace_root` を `valkey-cache`、`release` をそのファイル、`auto_pull` を true、`write` を true に設定します。各ビルドが書き込んだファイルを教えてください。ファイルは `valkey-cache/dist/` の下にあります。

資格情報の受け渡しに関する注記

Compose 経路では、資格情報は inject-value シークレットです(aggregate-auth.yaml)。その値はコンポーネントの環境パイプで、values.key が指定する変数 VALKEY_PASSWORD として受け渡され、Recipe はそれをイメージの VALKEY_EXTRA_FLAGS 変数を通じて --requirepass としてサーバーに渡します。そのため値はサービスの環境には現れますが、コマンドラインには現れません。イメージの起動スクリプトはこの変数を引用符なしで展開するため、空白を含むパスワードは起動時にサーバーを停止させ、*、?、[ を含むパスワードはサーバーのデータディレクトリ内のファイル名と照合されます。したがって、パスワードにはどちらも含めないでください。Recipe が読み取るどの変数でもない形で値が届くパスワードのアタッチメントは、保護されていないキャッシュをレンダリングするのではなく、スロットを示してビルドを停止させます。

合成 helm 経路は参照可能な資格情報を使用します (aggregate-helm-synth-auth.yaml)。値は Kubernetes Secret として具現化され、Deployment は env の secretKeyRef を通じてそれを参照し、Valkey は その環境変数を読み取る --requirepass 付きで起動されます。そのため、平文の パスワードが Deployment マニフェストに現れることはなく、Secret の中にのみ存在します。 これにより、環境変数からパスワードを自ら読み取らない公式の valkey/valkey イメージで、実際に認証が有効になります。

認証付きの Aggregates にある origin の値は開発用のプレースホルダーです。 実際のデプロイでは、資格情報ソースを通じて実際の値を指定してください。