RabbitMQ — 1 つの Aggregate、2 つのターゲット、オプションの認証
この例では、Developer が作成した 1 つの Aggregate から、単一の RabbitMQ メッセージブローカー(AMQP)を 2 つのターゲットへコンパイルします:
- ローカル開発向けの Docker Compose、そして
- Kubernetes。公式の上流
rabbitmqイメージを直接実行する、合成された helm Recipe を 使用します(永続ボリュームを持つ StatefulSet で、外部チャートは使用しません)。
同じ aggregate.yaml が両方を駆動します。ターゲットごとに変わるのは、
Manifest が選択する Recipe レイヤーだけです。2 つ目の Aggregate である aggregate-helm-synth-auth.yaml は、
参照可能なパスワード資格情報を付与した同じブローカーを Kubernetes 上で
示します。
ファイル
| ファイル | 役割 |
|---|---|
aggregate.yaml | Developer の意図:型 core/messaging/rabbitmq の broker コンポーネントが 1 つで、資格情報はありません。Recipe が決定論的なインライン開発用パスワードを提供します。 |
aggregate-auth.yaml | コンポーネントのオプションの password スロットに inject-value パスワード資格情報を付与した同じブローカー(Compose ターゲットで使用)。 |
aggregate-helm-synth-auth.yaml | 参照可能なパスワード資格情報を付与した同じブローカー。資格情報は Kubernetes Secret として実体化され、StatefulSet から参照されます(Kubernetes ターゲットで使用)。 |
manifest-compose.yaml | RabbitMQ の型を Compose の Recipe(compose/rabbitmq)に、資格情報を dotenv-secret にマッピングします。 |
manifest-helm-synth.yaml | RabbitMQ の型を合成された helm Recipe(helm/rabbitmq)に、資格情報を k8s-secret-from-parameter にマッピングします。 |
release-compose.yaml / release-helm-synth.yaml | 2 つのターゲット向けの Operator レコード。インライン開発用パスワードを使用します。 |
release-compose-auth.yaml / release-helm-synth-auth.yaml | 資格情報スロットを通じてパスワードを提供する Operator レコード。 |
Manifests 内の Recipe 参照は provider スコープ付き(compose/rabbitmq、
helm/rabbitmq)です。これは、同じ名前の Recipe が provider ごとに存在するためです。
示す内容
- 1 つの作成インターフェース、多数のターゲット。 1 つの Aggregate が、スタックが 何 であるかの信頼できる唯一の情報源です。各 Manifest は、それを どのように 実現するかを記述します。
- 永続的なブローカー。 RabbitMQ はキューとメッセージを永続化するため、コンポーネントは
stateful-serverとして型付けされます。Kubernetes では、合成された Recipe が、 RabbitMQ のデータディレクトリにマウントされるレプリカごとの永続ボリュームと、 安定したネットワーク ID のための Headless Service を持つ StatefulSet をレンダリングします。Compose サービスは、ローカル開発向けにブローカーを公開します。 - チャート不要の合成(Kubernetes)。 Kubernetes ターゲットは公式の
rabbitmqイメージを直接実行します。コンパイラは、コンポーネントのinfraサイジングから StatefulSet、ClusterIP Service、Headless Service を合成します。 取得や追跡が必要な外部チャートはありません。イメージタグはinfra.engine_versionで固定されるため、レンダリング結果に浮動タグは含まれません。 - ブローカーの両ポート。 イメージは管理機能が有効になっているため、ブローカーは コンテナ上と ClusterIP Service 上で AMQP ポート(5672)と管理ダッシュボード(15672)を 公開します。
- 決定論的な資格情報。 RabbitMQ は常に認証を行います。資格情報が
付与されていない場合、各 Recipe は固定のインライン開発用パスワードを提供するため、
レンダリング結果は実行間でバイト単位で同一になります。資格情報が
付与されている場合は、注入された値がブローカーのパスワードを設定します。Compose では
RABBITMQ_DEFAULT_PASSサービス環境変数になり、Kubernetes では Secret として実体化されて env のsecretKeyRefから参照されるため、 平文がレンダリングされたマニフェストに含まれることはありません。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example rabbitmq-brokerその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd rabbitmq-brokerビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き込みます。
# Local development (Docker Compose), inline development passwordaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline passwordaggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attachedaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullレンダリングされた成果物は dist/ 配下に出力されます。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。Workspace フォルダーにまだ `rabbitmq-broker` フォルダーがない場合は、`example` を `rabbitmq-broker` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `rabbitmq-broker` フォルダーに例が書き込まれます。次に、各 Release について 1 回ずつ、`release-compose.yaml`、`release-helm-synth.yaml`、`release-compose-auth.yaml`、`release-helm-synth-auth.yaml` の順に `build` ツールを呼び出してください。毎回、`workspace_root` を `rabbitmq-broker`、`release` をそのファイル、`auto_pull` を true、`write` を true に設定します。各ビルドが書き込んだファイルを教えてください。それらは `rabbitmq-broker/dist/` の下にあります。資格情報の受け渡しに関する注記
Compose では、資格情報は inject-value シークレットです。その値は
コンポーネントの環境パイプで受け渡され、RABBITMQ_DEFAULT_PASS サービス
環境変数になります。Kubernetes では、資格情報は参照可能です。
Kubernetes Secret として実体化され、StatefulSet が
env の secretKeyRef を介してそれを参照するため、平文のパスワードがワークロード
マニフェストに現れることはありません。認証用の Aggregates 内の origin 値は開発用の
プレースホルダーです。実際のデプロイでは、資格情報ソースを通じて実際の値を
提供してください。資格情報が付与されていない場合に使用されるインライン開発用パスワードも
同様に、ローカルでの使用に限られます。