> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> セルフホストデプロイメントの一部としてプロビジョニングされるすべてのリソースのリファレンス

エンタープライズ契約が確定すると、Cartesia はアカウント向けに以下のリソースをプロビジョニングします。プロビジョニング済みリソースはすべて [オンプレミスポータル](https://play.cartesia.ai/on-prem) からダウンロードできます。

<Note>オンプレミスポータルは、オンプレミスが有効化された組織下でのみアクセス可能です。表示されない場合は、アカウントスイッチャーでその組織に切り替えてください。</Note>

## サービスアカウント

アカウント用にサービスアカウントが作成されます。このサービスアカウントは以下のアクセス権を持ちます:

* Cartesia 提供のコンテナイメージをホストするプライベートアーティファクトレジストリへのアクセス。
* デプロイメント構成を含む共通ストレージバケット `gs://cartesia-onprem` へのアクセス。
* 顧客固有のアーティファクトをホストするプライベートストレージバケット `gs://cartesia-{{name}}` へのアクセス。

このサービスアカウントの JSON キーは [オンプレミスポータル](https://play.cartesia.ai/on-prem) からダウンロードしてください。

GCloud 上のリソースにアクセスする前に、サービスアカウントをアクティベートします:

```bash theme={null}
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 とホットリロードの挙動については [アーティファクトの管理](/self-hosted/managing-artifacts) を参照してください。

## デプロイメント構成

`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
```

最新リリースをダウンロードして検証します:

```bash theme={null}
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](/self-hosted/managed-kubernetes) |
| Kubernetes（Terraform — GCP GKE） | `gcp-terraform.tfvars.example`                                         | [マネージド Kubernetes](/self-hosted/managed-kubernetes) |
| Kubernetes（Helm のみ、既存クラスタ）      | `cartesia/values.yaml`（完全リファレンス）と `cartesia/sample-values.yaml`（厳選した例） | [マネージド Kubernetes](/self-hosted/managed-kubernetes) |
| Docker Compose / Swarm（ベータ）     | `local/.env.example`                                                   | [Docker](/self-hosted/docker-compose)               |

## コンテナレジストリ

イメージは `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 レジストリから取得する必要はありません。

### 利用可能なタグの一覧

最新順にソートして利用可能なイメージタグを一覧表示します:

```bash theme={null}
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 を認証します:

```bash theme={null}
cat /path/to/service-account.json | \
  docker login -u _json_key --password-stdin https://us-docker.pkg.dev
```

各イメージを pull、retag、push します。例:

```bash theme={null}
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 を設定します。