OpenBao — Kubernetes のシークレット管理サーバー
この例では、小さな実際のスタック(単一の OpenBao シークレット
サーバー)を、Developer が記述した 1 つの Aggregate から Kubernetes 向けにコンパイルします。基盤には
公式の OpenBao Helm チャートを使用します。
OpenBao は、トークン、パスワード、証明書などのシークレットを認証付きの HTTP API の背後で保存、生成し、 それらへのアクセスを制御します。また、その状態を永続的なデータボリューム上で保存時に暗号化します。ここでは単一のスタンドアロン サーバーとして動作し、状態を組み込みのファイルストレージバックエンドに保持するため、マネージドクラウドのリソースではなく、 永続ボリュームに支えられたステートフルな稼働中のサーバーとしてレンダリングされます。サーバーはクラスター内で実行時に 初期化およびアンシールされます(ルートトークンとアンシールキーは、起動後に稼働中のサーバーが生成します)。 そのため、Aggregate には認証情報が宣言されず、ビルド時にシークレットが 実体化されることもありません。
ファイル
| ファイル | 役割 |
|---|---|
aggregate.yaml | Developer の意図:組み込みの Web UI を有効にした単一の secrets コンポーネント(core/security/openbao)。 |
manifest.yaml | コンポーネントタイプを公式のソース取得済み Recipe(openbao)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けのオペレーターレコード:サーバーのコンピュートサイズとデータボリュームのサイズ。 |
示す内容
- 単一の記述面。 単一の Aggregate が、シークレットサーバーが何であるかの信頼できる唯一の情報源であり、 Manifest はそれをどのように実現するかを示します。
- 開発者の値がレンダリングまで流れます。 開発者の
ui_enabledの値は、チャートがマウントするサーバー設定に書き込まれ、 組み込みの Web UI の有効・無効を制御します。 - 永続ボリューム上のステートフルなサーバー。 ソース取得済みの Recipe は
ファイルストレージバックエンドを使うスタンドアロンモードを設定するため、サーバーは
暗号化された状態を
/openbao/dataにマウントされたPersistentVolumeClaim上に保持します。 そのサイズはオペレーターのstorage.sizeで決まります。 - レンダリング時の認証情報はありません。 OpenBao は実行時に自身で初期化とアンシールを行うため、
ビルドは認証情報を配線せず、
Secretも出力しません。レンダリングされた 出力は、同じ入力で実行するたびにバイト単位で同一です。 - 再現可能なイメージ。 Recipe はサーバーイメージを解決可能なリリースタグ(
quay.io/openbao/openbao:2.5.5)に固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example openbao-secretsその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd openbao-secretsビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。
aggrega pull --release release.yamlaggrega build --release release.yamlレンダリングされた成果物は dist/ 以下に出力されます。ビルドは aggrega pull 時に
アップストリームのチャートを OCI 参照で解決し、ロックファイルに固定します。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。Workspace フォルダーにまだ `openbao-secrets` フォルダーがない場合は、`example` を `openbao-secrets` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `openbao-secrets` フォルダーに例が書き込まれます。次に、`workspace_root` を `openbao-secrets`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `openbao-secrets/dist/` の下にあります。レンダリングされるもの
ビルドは、無駄のない単一ワークロードの OpenBao スタックを 7 つの Kubernetes オブジェクトとして出力します:
- OpenBao サーバー用の
StatefulSet、 - サーバー設定(ファイルストレージバックエンドと
API リスナー)を保持する
ConfigMap、 - 2 つの
Service(メインの API サービスと、StatefulSet が 安定した Pod ネットワーキングに使う内部のヘッドレスサービス)、 - サーバー Pod 用の
ServiceAccount、 - Kubernetes のサービスアカウントを認証するためにサーバーが使うトークンレビュー権限を
付与する
ClusterRoleBinding、 - サーバーの準備状態を確認する
helm.sh/hook: testのPod。
CustomResourceDefinition はありません。OpenBao は自己完結型のサーバーであり、クラスター API を拡張するコントローラーではないためです。サーバーイメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。