エアギャップ環境でのデプロイメント

Cartesia のライセンスサーバーへのインターネット接続がないデプロイメントでは、エアギャップモードで動作させることができます。このモードでは、リアルタイム認証の代わりにオフラインライセンスファイルを使用します。

オフラインライセンスファイルはオンプレミスポータルからダウンロードできます。詳細はプロビジョニング済みリソースを参照してください。

設定

Terraform
Helm

# In your .tfvars file
authenticate               = false
license_proxy_persistence  = true   # Required for air-gapped mode

infra:
  authenticate: false
licenseProxy:
  persistence:
    enabled: true
    storageClass: gp2  # Use appropriate storage class for your cluster

ライセンスの読み込み

インストール時にライセンスをシード（初回デプロイで推奨）するか、稼働中のクラスタの /license エンドポイントにアップロードできます。

インストール時

ダウンロードしたライセンスファイルを直接デプロイツールに渡します。チャートはライセンスを含む ConfigMap を作成し、初回起動時にそれを license-proxy のボリュームへコピーする initContainer を追加します。これにより、terraform apply / helm install 1 回でセットアップが完了します。

Terraform
Helm

# In your .tfvars file
authenticate              = false
license_proxy_persistence = true
license_proxy_seed_file   = "/path/to/license.json"

次のコマンドを実行します:

terraform apply

helm install cartesia ./cartesia \
  --set infra.authenticate=false \
  --set licenseProxy.persistence.enabled=true \
  --set-file licenseProxy.licenseContent=/path/to/license.json

ファイル内容を渡すには --set-file を使ってください。--set だと JSON を構造化された値としてパースしようとして失敗します。

このシードは一度きりのブートストラップであり、ライセンスが既にディスク上に存在する場合、initContainer はコピーをスキップします。後から POST /license 経由でアップロードされたライセンスが自動的に優先されます（license proxy は最新の issued_at を持つライセンスを選択します）。また、Pod の再起動でも上書きされません。シードされたライセンスをローテーションするには、新しいライセンスを POST /license でアップロードしてください（下記参照）。terraform apply / helm upgrade の再実行だけではディスク上の既存ライセンスを上書きしません。

稼働中のクラスタ

/license および /audit エンドポイントは、API Pod ではなく、cartesia-license-proxy サービス背後の license proxy Pod によって提供されます。

エアギャップモードでは、ライセンス管理のために /license エンドポイントが公開されます。

Port-Forward 経由

kubectl port-forward svc/cartesia-license-proxy 8080:8080 -n cartesia

別のターミナルで:

curl -X POST http://localhost:8080/license -d '<license-json>'

Ingress 経由

ingress が有効な場合:

curl -X POST https://<your-domain>/license -d '<license-json>'

監査ログの取得

エアギャップモードでは、利用状況の監査ログを取得するための /audit エンドポイントが利用できます:

curl -X GET https://<your-domain>/audit --output audits.tar

これらの監査ログには、課金照合のための利用メタデータが含まれます。トランスクリプトデータは一切含まれておらず、出力内容を確認することでそれを検証できます。

Overview

Deployments

ガイド

Performance

エアギャップ環境でのデプロイメント

設定

ライセンスの読み込み

インストール時

稼働中のクラスタ

Port-Forward 経由

Ingress 経由

監査ログの取得

​設定

​ライセンスの読み込み

​インストール時

​稼働中のクラスタ

​Port-Forward 経由

​Ingress 経由

​監査ログの取得

設定

ライセンスの読み込み

インストール時

稼働中のクラスタ

Port-Forward 経由

Ingress 経由

監査ログの取得