メインコンテンツへスキップ
エンタープライズ契約が確定すると、Cartesia はアカウント向けに以下のリソースをプロビジョニングします。プロビジョニング済みリソースはすべて オンプレミスポータル からダウンロードできます。
オンプレミスポータルは、オンプレミスが有効化された組織下でのみアクセス可能です。表示されない場合は、アカウントスイッチャーでその組織に切り替えてください。

​
サービスアカウント

アカウント用にサービスアカウントが作成されます。このサービスアカウントは以下のアクセス権を持ちます:
  • Cartesia 提供のコンテナイメージをホストするプライベートアーティファクトレジストリへのアクセス。
  • デプロイメント構成を含む共通ストレージバケット gs://cartesia-onprem へのアクセス。
  • 顧客固有のアーティファクトをホストするプライベートストレージバケット gs://cartesia-{{name}} へのアクセス。
このサービスアカウントの JSON キーは オンプレミスポータル からダウンロードしてください。 GCloud 上のリソースにアクセスする前に、サービスアカウントをアクティベートします: 
gcloud auth activate-service-account --key-file=/path/to/service-account.json
gsutil ls gs://cartesia-onprem/  # Verify access

​
顧客アーティファクトバケット

顧客固有のバケット gs://cartesia-{name} は、セルフホストデプロイメントが実行時に消費するボイスマイグレーションと LoRA チェックポイントをホストします: 
gs://cartesia-{name}/
  migrations/
    v2/
      migrations/         # voice and pronunciation-dictionary migration files
  loras/                  # LoRA checkpoints for cloned voices
API サーバーは migrations/v2/migrations/ から同期します。ワーカーは loras/ から LoRA チェックポイントを同期します。 Cartesia クラウド API に対して POST /onprem/add-voices または POST /onprem/add-pdict を呼び出すと、ファイルが migrations/v2/migrations/ に配置されます。マイグレーション API とホットリロードの挙動については アーティファクトの管理 を参照してください。

​
デプロイメント構成

cartesia-onprem バケットには、すべてのデプロイメント構成を保持するバージョン管理されたリポジトリ cartesia-kube が含まれています。 
gs://cartesia-onprem/
  cartesia-kube/
    latest/
      cartesia-kube-latest.tar.gz   # Latest release archive
      VERSION                        # Current version string
    releases/
      <version>/
        SHA256SUMS                   # Checksums for verification
最新リリースをダウンロードして検証します: 
BUCKET="cartesia-onprem"

gsutil cp gs://${BUCKET}/cartesia-kube/latest/cartesia-kube-latest.tar.gz .
gsutil cp gs://${BUCKET}/cartesia-kube/latest/VERSION .

LATEST_VERSION=$(cat VERSION)
gsutil cp gs://${BUCKET}/cartesia-kube/releases/${LATEST_VERSION}/SHA256SUMS .

mv cartesia-kube-latest.tar.gz cartesia-kube-${LATEST_VERSION}.tar.gz

sha256sum -c SHA256SUMS  # macOS: shasum -a 256 -c SHA256SUMS
tar -xzf cartesia-kube-${LATEST_VERSION}.tar.gz
展開すると、cartesia-kube にはすべてのデプロイ方法に必要なものが含まれています: 
cartesia-kube/
  benchmarking/          # Load testing and benchmarking tools
  cartesia/              # Helm chart + Docker Compose configs
    scripts/
      swarm/             # Docker Swarm deploy scripts
    templates/           # Kubernetes resource templates
      autoscaler/
      resources/
      services/
  infra/                 # Terraform configs
    aws/
      cartesia-eks/      # EKS deployment
    gcp/
      cartesia-gke/      # GKE deployment

​
構成ファイル

各デプロイ方法は cartesia-kube 内に独自の構成ファイルを持ちます。.example ファイルをコピーして値を埋め、デプロイ時に参照してください。
デプロイ方法構成ファイルドキュメント
Kubernetes（Terraform — AWS EKS）aws-terraform.tfvars.exampleマネージド Kubernetes
Kubernetes（Terraform — GCP GKE）gcp-terraform.tfvars.exampleマネージド Kubernetes
Kubernetes（Helm のみ、既存クラスタ）cartesia/values.yaml（完全リファレンス）と cartesia/sample-values.yaml（厳選した例）マネージド Kubernetes
Docker Compose / Swarm（ベータ）local/.env.exampleDocker

​
コンテナレジストリ

イメージは us-docker.pkg.dev/cartesia-external/self-serve にホストされており、リリースタグ（例: sonic-20251118）でタグ付けされます。完全なイメージ参照形式は次のとおりです: 
us-docker.pkg.dev/cartesia-external/self-serve/<image-name>:<release-tag>

​
イメージ

イメージ名説明
cartesia-apiAPI サーバー
cartesia-license-proxyライセンスの検証と適用
cartesia-sonic-azure-discoTTS ワーカー — sonic-3.5
cartesia-sonic-rosy-dragonTTS ワーカー — sonic-3
cartesia-sonic-royal-plantTTS ワーカー — sonic-2
cartesia-sonic-voice-cloneTTS ワーカー — voice cloning
NATS はパブリックイメージを使用するため、Cartesia レジストリから取得する必要はありません。

​
利用可能なタグの一覧

最新順にソートして利用可能なイメージタグを一覧表示します: 
gcloud artifacts docker images list \
  us-docker.pkg.dev/cartesia-external/self-serve/cartesia-api \
  --include-tags \
  --sort-by="~UPDATE_TIME"
cartesia-sonic-api は上表の任意のイメージ名に置き換えてください。~ プレフィックスは降順ソートで、最新タグを先頭に表示します。

​
プライベートレジストリへのミラーリング

エアギャップ環境やネットワーク制限のある環境では、デプロイ前にイメージを自社のレジストリにミラーリングしてください。 サービスアカウントで Docker を認証します: 
cat /path/to/service-account.json | \
  docker login -u _json_key --password-stdin https://us-docker.pkg.dev
各イメージを pull、retag、push します。例: 
CARTESIA_REGISTRY="us-docker.pkg.dev/cartesia-external/self-serve"
PRIVATE_REGISTRY="your-registry.example.com/cartesia"
RELEASE_TAG="sonic-20251118"
IMAGE="cartesia-api"

docker pull ${CARTESIA_REGISTRY}/${IMAGE}:${RELEASE_TAG}
docker tag  ${CARTESIA_REGISTRY}/${IMAGE}:${RELEASE_TAG} ${PRIVATE_REGISTRY}/${IMAGE}:${RELEASE_TAG}
docker push ${PRIVATE_REGISTRY}/${IMAGE}:${RELEASE_TAG}
上表の各イメージについて繰り返します。 その後、infra.imageRegistry（Helm）にプライベートレジストリの URL を設定します。