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.yaml | Developer の意図:単一の sealed-secrets コンポーネント(core/security/sealed-secrets)。 |
manifest.yaml | コンポーネントタイプを公式のソース付き Recipe(sealed-secrets)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けのオペレーターレコード:オペレーターのコンピュートサイジング。 |
示す内容
- 単一のオーサリング面。 1 つの Aggregate が、コントローラーが何であるかの信頼できる唯一の情報源となり、 Manifest がそれをどのように実現するかを記述します。
- HTTPS で配信されるチャート。 Recipe は OCI レジストリではなく HTTPS チャート
リポジトリからチャートを取得します。ビルドは
aggrega pull時にそれを解決して固定します。 - チャートの CRD ディレクトリに同梱される CRD。
SealedSecretCustomResourceDefinition はテンプレートではなく、チャートの Helm ネイティブな CRD ディレクトリに置かれています。 リリースとともに無条件で出力にレンダリングされます。 - クラスターを拡張するコントローラー、トポロジーエッジなし。 sealed-secrets は独自の
カスタムリソースをクラスター API に追加します。コンシューマーは
SealedSecretリソースを宣言してシークレットを要求するため、コンポーネントはusesエッジを結ばず、何もエクスポートしません。 - 単一でまとまったコントローラー。 チャートは RBAC と Service を伴う 1 つのコントローラーをレンダリングし、 外部のデータストア、キャッシュ、ブローカーは含みません。レンダリング出力は 同じ入力に対する実行間でバイト単位で同一です。
- 再現可能なイメージ。 Recipe はコントローラーイメージを解決可能なリリースタグ(
docker.io/bitnami/sealed-secrets-controller:0.38.4)に固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example sealed-secrets-controllerその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd sealed-secrets-controllerビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。
aggrega pull --release release.yamlaggrega 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 つ — コントローラーのサービスとそのメトリクスサービス。
コントローラーイメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。