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