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

NGINX ゲートウェイ — アップストリームへのリバースプロキシルーティング、2 つのターゲット

この例では、小規模ながら実用的なスタック(web バックエンドの前段に置かれた NGINX リバースプロキシゲートウェイ)を、Developer が作成した 1 つの Aggregate から 2 つのターゲットへコンパイルします:

  • ローカル開発向けの Docker Compose、そして
  • クラスタ向けの合成された Kubernetes マニフェスト。

同じ aggregate.yaml が両方を駆動します。ターゲットごとに変わるのは、 Manifest が選択する Recipe レイヤーだけです。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:web バックエンド(core/devtool/adminer)と、バックエンドの upstream 利用を宣言する proxy ゲートウェイ(core/gateway/nginx)。
manifest-compose.yamlゲートウェイの型を Compose の Recipe(compose/nginx)に、バックエンドを Compose の Adminer Recipe にマッピングします。
manifest-helm-synth.yamlゲートウェイの型を合成 helm の Recipe(helm/nginx)に、バックエンドをオフラインの Adminer helm Recipe にマッピングします。
release-compose.yaml / release-helm-synth.yaml2 つのターゲット向けの Operator レコード。

示す内容

  • 1 つの作成インターフェース、多数のターゲット。 1 つの Aggregate が、スタックが 何 であるかの信頼できる唯一の情報源です。各 Manifest は、それを どのように 実現するかを記述します。
  • String Pipe を通じたアップストリームルーティング。 ゲートウェイはバックエンドの upstream 利用を宣言します。バックエンドの Recipe の provides.host と provides.port がゲートウェイへパイプされ、その proxy_pass ターゲットにレンダリングされます。コンパイラは文字列を解釈せずにルーティングするため、 同じエッジから、Compose のビルドでは compose のサービス名が、Kubernetes のビルドでは Service 名が接続されます。
  • Provider に適した設定。 どちらのターゲットでも、ゲートウェイはコンテナ起動時に、 注入されたアップストリームへ転送する proxy_pass を持つ最小限の NGINX server ブロックを書き出し、 その後 nginx をフォアグラウンドで起動します。Kubernetes ターゲットでは、これを外部の Helm チャートを使わずに、ステートレスな Deployment と ClusterIP Service として 実現します。
  • 再現可能なイメージ。 Kubernetes ターゲットは、明示的なタグに固定された公式のアップストリーム nginx イメージを実行するため、レンダリングされた Deployment は 安定したイメージを参照します。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example nginx-gateway

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

Terminal window
cd nginx-gateway

ビルド

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

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)
aggrega build --release release-helm-synth.yaml --auto-pull

レンダリングされた成果物は dist/ 以下に出力されます。Kubernetes ターゲットはオフラインで プレーンなマニフェストをレンダリングするため、チャートのプルは不要です。

AI アシスタントを使う

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

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

注入されたアップストリームの内容

Compose では、ゲートウェイサービスが、バックエンドの compose サービス名とポートを指す server ブロックを持つ NGINX を実行します:

server { listen 8000; location / { proxy_pass http://web:8080; } }

Kubernetes では、同じルーティングが、nginx の起動前に server 設定を書き出すコンテナコマンドに渡され、 バックエンドの Service を指します。 helm provider は、この Service をバックエンドとその default サービスキーに基づいて命名します:

server { listen 8080; location / { proxy_pass http://web-default:8080; } }

どちらも同じ Aggregate のエッジから解決されます。バックエンドのホストとポートは upstream 利用を通じて渡され、各ターゲットがそれぞれの流儀でレンダリングします。

実行する(Compose)

Terminal window
aggrega build --release release-compose.yaml --auto-pull
docker compose -f dist/app/compose/docker-compose.yaml up -d

http://localhost:8000 を開くと、NGINX がリクエストをバックエンドへ転送します。停止するには docker compose -f dist/app/compose/docker-compose.yaml down を実行します。