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

# SambaStack Pod リファレンス

このページでは、SambaStack のインストールの一部としてデプロイされる主要な Kubernetes Pod を、ホステッド環境とオンプレミス環境の両方について一覧します。各 Pod は論理的なシステムコンポーネントを表しており、プラットフォーム内で担う主な機能とあわせて説明します。

このリファレンスは、次の用途に役立ちます。

* インストール時および実行時における各 Pod の役割の理解
* デプロイやアップグレード時における Pod レベルの問題のトラブルシューティング
* 認証、ルーティング、推論、ストレージ、プラットフォーム管理を担当するコンポーネントの特定

| Pod 名 | 説明 |
| :- | :- |
| auth-and-billing-\[...] | UI アクセスと API リクエストに関する認証、API キーの検証、認可を管理します。また、データベースマイグレーション、ID 管理、クレジット、ユーザーのサービスティアも担当し、ティア管理操作用の /admin エンドポイントを公開します。 |
| cloud-ui-\[...] | SambaStack サービスを操作するための Web ベースのユーザーインターフェイスを提供します。 |
| gateway-\[...] | ユーザーからのリクエストを受信し、inference-router サービスにルーティングする API ゲートウェイです。 |
| inf-operator-0 | 推論エンジンとキャッシュ Pod のライフサイクルをオーケストレーションします。中央のモデルデータベースとして機能し、モデルのメタデータとサービスティア情報を他のコンポーネントに提供します。 |
| inf-\<Model Name>-cache-\[...] | デプロイされた各モデルのモデルアーティファクト (PEF とチェックポイント) をキャッシュし、読み込み時間を最適化します。 |
| inf-\<Model Name>-q-default-n-0 | 指定されたモデルの推論リクエストを処理するワーカー Pod です。 |
| inference-router-\[...] | リクエストのバッチ処理とインテリジェントなルーティングを管理し、利用可能なワーカー Pod に推論ワークロードを分散します。 |
| keycloak-0 / keycloak-operator-\[...] | デフォルトのログインインターフェイスを備えた ID・アクセス管理を提供します。カスタム OIDC プロバイダーを使用する場合や、認証が不要な場合は無効化できます。 |
| sambastack-cloudnative-pg-\[...] | PostgreSQL データベースストレージを初期化・管理します。sambastack-postgres-\* インスタンスを構成・保守します。 |
| sambastack-global-queue-redis-master-0 | システム全体のグローバルタスクキューとジョブスケジューリングを管理する Redis インスタンスです。 |
| sambastack-localpv-provisioner-\[...] | ローカルディスクストレージを使用して Kubernetes の PersistentVolume をプロビジョニングします。PostgreSQL のデータ永続化に不可欠です。 |
| sambastack-postgres-\[1-3] | auth-and-billing や keycloak などのコアサービスに永続ストレージを提供する、PostgreSQL データベースクラスターのインスタンスです。 |
| sambastack-response-queue-redis-master-0 | 非同期処理のレスポンスキュー管理専用の Redis インスタンスです。 |

<Info>
  上記の Pod 名において、プレースホルダ `[...]` は、実際の Kubernetes Pod 名に現れる可変のサフィックスを表します。

  **例えば**、`auth-and-billing-[...]` は、`auth-and-billing-123ab45c78d-efghi` のような実際の Pod 名を抽象化した表記です。実際のサフィックスは、環境や時期によって異なる場合があります。
</Info>