プロビジョニング済みリソース

エンタープライズ契約が確定すると、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.example`	Docker

コンテナレジストリ

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

us-docker.pkg.dev/cartesia-external/self-serve/<image-name>:<release-tag>

イメージ

イメージ名	説明
`cartesia-api`	API サーバー
`cartesia-license-proxy`	ライセンスの検証と適用
`cartesia-sonic-azure-disco`	TTS ワーカー — sonic-3.5
`cartesia-sonic-rosy-dragon`	TTS ワーカー — sonic-3
`cartesia-sonic-royal-plant`	TTS ワーカー — sonic-2
`cartesia-sonic-voice-clone`	TTS ワーカー — 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 を設定します。

​サービスアカウント

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

​デプロイメント構成

​構成ファイル

​コンテナレジストリ

​イメージ

​利用可能なタグの一覧

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

サービスアカウント

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

デプロイメント構成

構成ファイル

コンテナレジストリ

イメージ

利用可能なタグの一覧

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