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

Contour ゲートウェイ — Kubernetes ネイティブなイングレスコントローラー

この例では、小規模ながら実際のスタックである Contour イングレスゲートウェイを、 Developer が記述した 1 つの Aggregate から Kubernetes へコンパイルします。開発者はゲートウェイが何であるかを宣言し、 単一の Ops Recipe がその意図を公式の project-contour Helm チャート(プロジェクトの HTTPS チャートリポジトリから提供)にマッピングして、 Kubernetes オブジェクトをレンダリングします。

Contour は Kubernetes ネイティブなイングレスコントローラーです。そのコントロールプレーンは クラスターの Ingress リソースと HTTPProxy リソースを監視し、Envoy データ プレーンを構成します。Envoy はクライアントの HTTP および HTTPS トラフィックを終端し、それらのリソースが指定する バックエンドサービスへ負荷分散します。ルーティングの入力は配線されたアップストリームではなく、クラスター 自身の Ingress オブジェクトであるため、ゲートウェイは uses エッジを持ちません。アプリケーションは、そのイングレスクラスに対して Ingress リソースを宣言することで ゲートウェイに到達します。同じ理由から、スタンドアロンのローカルコンテナ形態を持たないため、この ファミリーは Helm Recipe のみを提供し、Compose ターゲットはありません。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:調整対象のイングレスクラスを指定する単一の gateway コンポーネント(core/gateway/contour)。
manifest.yamlゲートウェイの型を project-contour Helm Recipe(contour)にマッピングします。
release.yamlKubernetes ターゲット向けのオペレーターレコード:Envoy サービスポートと、コントロールプレーン/データプレーンのサイジング。

示す内容

  • Ops Recipe によって実現される単一のオーサリング面。 Aggregate は ゲートウェイが何であるかの信頼できる情報源です。Manifest は、ゲートウェイの型を名前で Recipe にマッピングすることで、 それをどのように実現するかを示し、Release は運用上のサイジングを提供します。Developer の意図と Ops のマッピングは分離されたままです。
  • 1 つのコンポーネントからコントロールプレーンとデータプレーンを生成。 Recipe はイングレスコントローラーの 両方の部分をレンダリングします。Contour コントロールプレーン用の Deployment と Envoy データプレーン用の DaemonSet で、両者はチャートによって接続されます。
  • イングレスクラスの所有。 開発者の ingress_class_name の値は チャートに渡され、チャートはその名前の IngressClass を作成します。アプリケーションは Ingress リソースでそのクラスを参照することで、ゲートウェイへルーティングします。
  • CRD の管理。 Contour は自身の CustomResourceDefinition(HTTPProxy ファミリー)をインストールして管理します。Recipe は CRD 管理をデフォルトで有効にしています。CRD が事前にインストールされている場合は、 infra.overrides.manage_crds で無効にします。
  • データプレーンのエントリポイント。 Envoy の Service はデフォルトで LoadBalancer として公開されます。オペレーターは HTTP サービスポートを infra.port で設定し、サービスタイプを infra.overrides.service_type で変更できます。
  • 再現可能なイメージ。 Recipe は Contour と Envoy のイメージを明示的なリリースタグに固定し直すため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example contour-gateway

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

Terminal window
cd contour-gateway

ビルド

このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

レンダリングされた成果物は dist/ の下に出力されます。ビルドは aggrega pull でアップストリームのチャートを解決し、ロックファイルに固定します。

AI アシスタントを使う

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

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

レンダリングされるもの

ビルドはイングレスコントローラーのスタック全体を出力します。

  • Contour コントロールプレーンを実行する Deployment、
  • Envoy データプレーンを実行する DaemonSet、
  • Contour の CustomResourceDefinition、
  • contour という名前の IngressClass、
  • HTTP ポート 80 と HTTPS ポート 443 で Envoy の前段に置かれる LoadBalancer 型の Service、

に加えて、補助的な ConfigMap、証明書生成用の Job、コントロールプレーンの Service、NetworkPolicy、RBAC、ServiceAccount です。Contour と Envoy のイメージはリリースタグに固定されているため、すべてのワークロードが固定されたイメージタグを参照します。