> ## 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.

# カスタムバンドルの作成

複数のモデルを 1 つの単位としてサービングする場合、投機的デコーディングを設定する場合、または名前付きの構成を検証して共有する場合に、バンドルを作成します。バンドルは、1 つ以上のモデルとプロファイルのペアを組み合わせた、再利用可能な名前付きの `ModelBundle` リソースです。

バンドルを作成しただけでは、サービングは開始されません。バンドルが検証に合格したら、[バンドルのデプロイ](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/deploying-models-and-bundles/deploy-a-bundle.md) の説明に従って `ModelDeployment` でデプロイします。

> [!NOTE]
>
> バンドルは必須ではありません。単一のモデルをサービングする場合は、プロファイルと組み合わせて直接デプロイします。[単一モデルのデプロイ](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/deploying-models-and-bundles/deploy-a-single-model.md) をご覧ください。

## 前提条件

バンドルを作成する前に、お使いの環境に応じたクイックスタートを完了してください。

> **[クイックスタート - ホステッド](/docs/ja/v2.1.1/sambastack/getting-started/hosted.md)**
>
> ホステッド版 SambaStack のシステムセットアップ

> **[クイックスタート - オンプレミス](/docs/ja/v2.1.1/sambastack/getting-started/on-prem.md)**
>
> オンプレミス版 SambaStack のシステムセットアップ

あわせて、以下を確認してください。

* [モデル構成](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md#モデル構成) と [Legalizer の結果](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md#legalizer-の結果) を含む、[ModelBundle](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md) のフィールドリファレンスをご確認ください。
* バンドルに含めるモデルとプロファイルを特定し、各ペアに互換性があることを確認してください。[利用可能なモデルとプロファイルの特定](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/deploying-models-and-bundles/overview#利用可能なモデルとプロファイルの特定) をご覧ください。
* 利用可能なモデルチェックポイントについては、[対応モデルとバンドル](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/supported-models-and-bundles.md) をご確認ください。
* 投機的デコーディングのペアを設定する場合は、[投機的デコーディングによるデプロイ](/docs/ja/v2.1.1/sambastack/service-administration/performance/deploy-with-speculative-decoding.md) をご確認ください。

## バンドルの作成

**1. YAML ファイルの作成**

ModelBundle の YAML ファイルを作成します。

```yaml theme={}
apiVersion: sambanova.ai/v1alpha1
kind: ModelBundle
metadata:
  name: mb-gpt120
spec:
  modelConfigs:
  - model: gpt-oss-120b:1
    profile: gpt-oss-fp8-dyt
    batchingConfig:
      8k:
        batch_sizes: [2]
      32k:
        batch_sizes: [2]
      64k:
        batch_sizes: [2]
      128k:
        batch_sizes: [2]
```

投機的デコーディングを含む複数モデルのバンドルについては、[ModelBundle の構造](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md#構造) の例をご覧ください。

**2. ModelBundle の適用**

**Hosted**

```bash theme={}
kubectl apply -f <modelbundle-file>.yaml
```

**On Premise**

```bash theme={}
kubectl -n <namespace> apply -f <modelbundle-file>.yaml
```

**3. Legalizer による検証の確認**

バンドルを適用すると Legalizer が自動的に実行され、構成が RDU のメモリに収まるかどうかを検証します。

**Hosted**

```bash theme={}
kubectl describe modelbundle <bundle-name>
```

**On Premise**

```bash theme={}
kubectl -n <namespace> describe modelbundle.sambanova.ai <bundle-name>
```

**検証成功**

```text theme={}
Status:
  Conditions:
    Last Transition Time:  2026-06-22T21:11:05.689262+00:00
    Message:               ModelBundle is Valid
    Observed Generation:   1
    Reason:                ValidationSucceeded
    Status:                True
    Type:                  Valid
```

**検証失敗**

```text theme={}
Status:
  Conditions:
    Last Transition Time:  2026-06-22T21:11:54.975311+00:00
    Message:               <error-details>
    Reason:                ValidationFailed
    Status:                False
    Type:                  Valid
```

`Message` フィールドには、Legalizer のエラーがある場合はそれを含む、エラーの詳細が含まれます。

メモリ使用率や警告を含む Legalizer の結果を直接確認するには、次を実行します。

```bash theme={}
kubectl get modelbundle <bundle-name> -o jsonpath='{.status.legalizerInfo}'
```

ステータスの完全な構造とフィールドの説明については、[Legalizer の結果](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md#legalizer-の結果) をご覧ください。

> [!WARNING]
>
> バンドルが `ValidationSucceeded` を示すまで、デプロイに進まないでください。

## トラブルシューティング

バンドルは、デプロイ可能になる前に Legalizer によって検証されます。Legalizer が報告するエラーと警告、およびその解決方法については、[Legalizer の検証失敗](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/deploying-models-and-bundles/troubleshooting.md#legalizer-の検証失敗) をご覧ください。

## 次のステップ

> **[バンドルのデプロイ](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/deploying-models-and-bundles/deploy-a-bundle.md)**
>
> 作成したバンドルのサービング

> **[ModelBundle](/docs/ja/v2.1.1/sambastack/service-administration/model-deployment/custom-resources/model-bundle.md)**
>
> バンドルリソースの全フィールドのリファレンス