> ## 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.2.3/sambastack/service-administration/model-deployment/deploying-models-and-bundles/deploy-a-bundle) の説明に従って `ModelDeployment` でデプロイします。

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

## 前提条件

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

<CardGroup cols={2}>
  <Card icon="list-check" href="/docs/ja/v2.2.3/sambastack/getting-started/hosted" title="クイックスタート - ホステッド">
    ホステッド版 SambaStack のシステムセットアップ
  </Card>

  <Card icon="list-check" href="/docs/ja/v2.2.3/sambastack/getting-started/on-prem" title="クイックスタート - オンプレミス">
    オンプレミス版 SambaStack のシステムセットアップ
  </Card>
</CardGroup>

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

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

## バンドルの作成

<Steps>
  <Step title="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.2.3/sambastack/service-administration/model-deployment/custom-resources/model-bundle#構造) の例をご覧ください。
  </Step>

  <Step title="ModelBundle の適用">
    <Tabs>
      <Tab title="Hosted">
        ```bash theme={}
        kubectl apply -f <modelbundle-file>.yaml
        ```
      </Tab>

      <Tab title="On Premise">
        ```bash theme={}
        kubectl -n <namespace> apply -f <modelbundle-file>.yaml
        ```
      </Tab>
    </Tabs>
  </Step>

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

    <Tabs>
      <Tab title="Hosted">
        ```bash theme={}
        kubectl describe modelbundle <bundle-name>
        ```
      </Tab>

      <Tab title="On Premise">
        ```bash theme={}
        kubectl -n <namespace> describe modelbundle.sambanova.ai <bundle-name>
        ```
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="検証成功">
        ```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
        ```
      </Tab>

      <Tab title="検証失敗">
        ```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 のエラーがある場合はそれを含む、エラーの詳細が含まれます。
      </Tab>
    </Tabs>

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

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

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

<Warning>
  バンドルが `ValidationSucceeded` を示すまで、デプロイに進まないでください。
</Warning>

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

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

## 次のステップ

<CardGroup cols={2}>
  <Card icon="layer-group" href="/docs/ja/v2.2.3/sambastack/service-administration/model-deployment/deploying-models-and-bundles/deploy-a-bundle" title="バンドルのデプロイ">
    作成したバンドルのサービング
  </Card>

  <Card icon="cube" href="/docs/ja/v2.2.3/sambastack/service-administration/model-deployment/custom-resources/model-bundle" title="ModelBundle">
    バンドルリソースの全フィールドのリファレンス
  </Card>
</CardGroup>