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

sealed-secrets — Kubernetes SealedSecret 復号コントローラー

この例では、小規模ながら実際のスタックである sealed-secrets コントローラーを、 Developer が作成した 1 つの Aggregate から Kubernetes 向けにコンパイルします。基盤には HTTPS チャートリポジトリから配信される 公式 sealed-secrets Helm チャートを使用します。

sealed-secrets を使うと、暗号化されたシークレットをソース管理に安全にコミットできます。 公開鍵がシークレットを SealedSecret カスタムリソースへ暗号化し、 対応する秘密鍵を保持するクラスタースコープのコントローラーがそれを復号して ネイティブな Kubernetes Secret に戻します。このコントローラーは、アプリケーションがルーティングする先のサーバーではなく、 独自の SealedSecret カスタムリソースでクラスター API を拡張するものです。そのため uses エッジを持たず、 コンシューマーに何もエクスポートしません。アプリケーションは SealedSecret リソースを宣言することでシークレットを取得し、コントローラーが対応する Kubernetes Secret を復元します。 コントローラーはシーリング用の鍵ペアを実行時にクラスター内で生成するため、 レンダリング時に鍵素材は生成されません。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:単一の sealed-secrets コンポーネント(core/security/sealed-secrets)。
manifest.yamlコンポーネントタイプを公式のソース付き Recipe(sealed-secrets)にマッピングします。
release.yamlKubernetes ターゲット向けのオペレーターレコード:オペレーターのコンピュートサイジング。

示す内容

  • 単一のオーサリング面。 1 つの Aggregate が、コントローラーが何であるかの信頼できる唯一の情報源となり、 Manifest がそれをどのように実現するかを記述します。
  • HTTPS で配信されるチャート。 Recipe は OCI レジストリではなく HTTPS チャート リポジトリからチャートを取得します。ビルドは aggrega pull 時にそれを解決して固定します。
  • チャートの CRD ディレクトリに同梱される CRD。 SealedSecret CustomResourceDefinition はテンプレートではなく、チャートの Helm ネイティブな CRD ディレクトリに置かれています。 リリースとともに無条件で出力にレンダリングされます。
  • クラスターを拡張するコントローラー、トポロジーエッジなし。 sealed-secrets は独自の カスタムリソースをクラスター API に追加します。コンシューマーは SealedSecret リソースを宣言してシークレットを要求するため、コンポーネントは uses エッジを結ばず、何もエクスポートしません。
  • 単一でまとまったコントローラー。 チャートは RBAC と Service を伴う 1 つのコントローラーをレンダリングし、 外部のデータストア、キャッシュ、ブローカーは含みません。レンダリング出力は 同じ入力に対する実行間でバイト単位で同一です。
  • 再現可能なイメージ。 Recipe はコントローラーイメージを解決可能なリリースタグ(docker.io/bitnami/sealed-secrets-controller:0.38.4)に固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

ビルド

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

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

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

AI アシスタントを使う

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

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

レンダリングされるもの

ビルドは sealed-secrets コントローラーを一連の Kubernetes オブジェクトとして出力します:

  • sealed-secrets API(SealedSecret)用の CustomResourceDefinition が 1 つ、
  • Deployment が 1 つ — コントローラー、
  • それをバインドする RBAC:ClusterRole が 1 つ、ClusterRoleBinding が 1 つ、Role が 2 つ、 RoleBinding が 2 つ、
  • ServiceAccount が 1 つ、
  • Service が 2 つ — コントローラーのサービスとそのメトリクスサービス。

コントローラーイメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。