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.yaml | Developer の意図:調整対象のイングレスクラスを指定する単一の gateway コンポーネント(core/gateway/contour)。 |
manifest.yaml | ゲートウェイの型を project-contour Helm Recipe(contour)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けのオペレーターレコード: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 アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example contour-gatewayその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd contour-gatewayビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。
aggrega pull --release release.yamlaggrega 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 のイメージはリリースタグに固定されているため、すべてのワークロードが固定されたイメージタグを参照します。