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

cert-manager — Kubernetes の TLS 証明書ライフサイクルコントローラ

この例では、小規模ながら実際のスタックである cert-manager 証明書 コントローラを、Developer が作成した 1 つの Aggregate から Kubernetes へコンパイルします。 開発者は cert-manager が何であるかを宣言し、1 つの Ops Recipe がその意図を jetstack レジストリの公式 cert-manager Helm チャートにマッピングして、 Kubernetes オブジェクトをレンダリングします。

cert-manager はクラスタスコープの Kubernetes アドオンで、ACME(Let’s Encrypt)、プライベート CA、Vault などの発行元からの X.509 証明書の発行と 更新を自動化します。クラスタを独自の Certificate、Issuer、ClusterIssuer カスタムリソースで拡張します。アプリケーションは アップストリームを配線するのではなく、これらのリソースを宣言することで証明書を要求します。そのため、 このコンポーネントは uses エッジを持ちません。同じ理由で、単独の ローカルコンテナ形態がないため、このファミリーは Helm Recipe のみを提供し、 Compose ターゲットはありません。このコンポーネントが公開するのは、Prometheus サーバーが メトリクスを見つける場所だけです。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:CRD のインストールを有効にした単一の cert-manager コンポーネント(core/security/cert-manager)。
manifest.yamlコンポーネントタイプを cert-manager Helm Recipe(cert-manager)にマッピングします。
release.yamlKubernetes ターゲット向けのオペレーターレコード:コントローラ/Webhook/CA インジェクターのサイジング。

示す内容

  • 1 つのオーサリング面を Ops Recipe で実現。 Aggregate は cert-manager が何であるかの信頼できる情報源です。Manifest はコンポーネントタイプを 名前で Recipe にマッピングすることで、それをどのように実現するかを示し、Release は 運用上のサイジングを提供します。Developer の意図と Ops のマッピングは分離されたままです。
  • 1 つのコンポーネントから連携する 3 つのワークロード。 Recipe は cert-manager の 3 つの構成要素すべてをレンダリングします。証明書リクエストを調整する コントローラの Deployment、カスタムリソースを検証しデフォルト値を設定する Webhook の Deployment、そして Webhook の CA バンドルをクラスタに配線する CA インジェクターの Deployment です。
  • 証明書 API のインストール。 開発者の install_crds の値は チャートに渡され、チャートが cert-manager の CustomResourceDefinition( Certificate、Issuer、ClusterIssuer、および ACME の Order/Challenge リソース)をインストールします。CRD を別の手段で管理する場合は false に設定します。
  • アドミッションの配線。 チャートは Webhook が提供する ValidatingWebhookConfiguration と MutatingWebhookConfiguration、Webhook の Service、および 完全な RBAC セット(コントローラの責務ごとに 1 つの ClusterRole/ClusterRoleBinding と リーダー選出用の Role)を出力し、コントローラが必要な 権限を持てるようにします。
  • 再現可能なイメージ。 チャートは解決可能なリリースタグを提供し、Recipe はコントローラー、Webhook、CA インジェクター、ACME ソルバーのイメージをそれらのタグに固定し直すため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example cert-manager-tls

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

Terminal window
cd cert-manager-tls

ビルド

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

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

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

AI アシスタントを使う

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

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

レンダリングされるもの

ビルドは cert-manager の完全なスタックを出力します。3 つの Deployment(コントローラー、Webhook、CA インジェクター)、install_crds が有効な場合の 6 つの cert-manager CustomResourceDefinition、ValidatingWebhookConfiguration と MutatingWebhookConfiguration、Webhook の Service、コントローラーの ServiceAccount、そして ClusterRole、ClusterRoleBinding、リーダー選出用の Role と RoleBinding からなる RBAC セットです。さらに、インストール後の Job(証明書 API が提供可能になるまで待機する起動時 API チェック)と、コントローラーと CA インジェクターそれぞれのメトリクス Service も含まれ、合計 50 個の Kubernetes オブジェクトになります。コントローラー、Webhook、CA インジェクター、ACME ソルバーのイメージはリリースタグに固定されているため、すべてのワークロードが固定されたイメージタグを参照します。