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

OpenBao — Kubernetes のシークレット管理サーバー

この例では、小さな実際のスタック(単一の OpenBao シークレット サーバー)を、Developer が記述した 1 つの Aggregate から Kubernetes 向けにコンパイルします。基盤には 公式の OpenBao Helm チャートを使用します。

OpenBao は、トークン、パスワード、証明書などのシークレットを認証付きの HTTP API の背後で保存、生成し、 それらへのアクセスを制御します。また、その状態を永続的なデータボリューム上で保存時に暗号化します。ここでは単一のスタンドアロン サーバーとして動作し、状態を組み込みのファイルストレージバックエンドに保持するため、マネージドクラウドのリソースではなく、 永続ボリュームに支えられたステートフルな稼働中のサーバーとしてレンダリングされます。サーバーはクラスター内で実行時に 初期化およびアンシールされます(ルートトークンとアンシールキーは、起動後に稼働中のサーバーが生成します)。 そのため、Aggregate には認証情報が宣言されず、ビルド時にシークレットが 実体化されることもありません。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:組み込みの Web UI を有効にした単一の secrets コンポーネント(core/security/openbao)。
manifest.yamlコンポーネントタイプを公式のソース取得済み Recipe(openbao)にマッピングします。
release.yamlKubernetes ターゲット向けのオペレーターレコード:サーバーのコンピュートサイズとデータボリュームのサイズ。

示す内容

  • 単一の記述面。 単一の Aggregate が、シークレットサーバーが何であるかの信頼できる唯一の情報源であり、 Manifest はそれをどのように実現するかを示します。
  • 開発者の値がレンダリングまで流れます。 開発者の ui_enabled の値は、チャートがマウントするサーバー設定に書き込まれ、 組み込みの Web UI の有効・無効を制御します。
  • 永続ボリューム上のステートフルなサーバー。 ソース取得済みの Recipe は ファイルストレージバックエンドを使うスタンドアロンモードを設定するため、サーバーは 暗号化された状態を /openbao/data にマウントされた PersistentVolumeClaim 上に保持します。 そのサイズはオペレーターの storage.size で決まります。
  • レンダリング時の認証情報はありません。 OpenBao は実行時に自身で初期化とアンシールを行うため、 ビルドは認証情報を配線せず、Secret も出力しません。レンダリングされた 出力は、同じ入力で実行するたびにバイト単位で同一です。
  • 再現可能なイメージ。 Recipe はサーバーイメージを解決可能なリリースタグ(quay.io/openbao/openbao:2.5.5)に固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example openbao-secrets

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

Terminal window
cd openbao-secrets

ビルド

このワークスペースには .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 のツールのみを使用し、フォルダーは自分で作成しないでください。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 を拡張するコントローラーではないためです。サーバーイメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。