概要
カスタムチェックポイントのデプロイは、大きく分けて次の 4 つの作業で構成されます。- チェックポイント変換ツールを使用して、チェックポイントを SambaNova 互換形式に変換する。
- SambaNova から提供されたサービスアカウントに読み取り権限を付与したプライベートな Google Cloud Storage バケットに変換済みチェックポイントをアップロードする。または、クラスターから読み取り可能な NFS 上に配置する。
- モデルマニフェスト (Model Manifest) を作成してチェックポイントを登録する。
- パスと名前を指定して、デプロイ用の Bundle でチェックポイントを参照する。
このワークフローを開始する前に、チェックポイントの変換プロセスを完了しておいてください。手順はチェックポイント変換ツールのページをご参照ください。
前提条件
カスタムチェックポイントをデプロイする前に、以下を準備してください。- SambaNova 互換形式に変換済みのチェックポイント (チェックポイント変換ツールを参照)
- NFS マウント済みのストレージ、または Google Cloud Storage (GCS) バケットへのアクセス
- SambaNova から提供されたサービスアカウントの JSON ファイル
- SambaStack クラスターにアクセスできるように構成された
kubectl - Bundle と Bundle Template を含む、モデルデプロイの概念の理解
カスタムチェックポイントの対応モデル
カスタムチェックポイントのデプロイは、SambaStack の拡大を続けるベースモデル群でサポートされています。カスタムチェックポイントに対応するモデルは、対応モデルとバンドルの表でご確認ください。カスタムチェックポイントのデプロイ手順
チェックポイントの変換
カスタムチェックポイントやファインチューニング済みのチェックポイントは、デプロイする前に、SambaNova の SN40L ハードウェアに最適化された形式に変換する必要があります。SambaNova は、ローカルで実行できる Docker コンテナとしてチェックポイント変換ツールを提供しています。このツールは変換済みチェックポイントのアーティファクトを生成し、それを SambaStack にアップロードして推論用にデプロイできます。まず、チェックポイント変換ツールのドキュメントのダウンロードとセットアップセクションの手順に従ってください。変換ツールのコンテナをダウンロードし、お使いの SambaStack インスタンスとモデルメタデータを同期すればセットアップは完了です。セットアップ後、チェックポイント変換ツールのドキュメントのチェックポイントの変換と検証セクションに記載された手順で、カスタムチェックポイントを SambaNova 互換形式に変換します。
GCS バケットの権限設定
クラスターに NFS がマウントされている場合、このセクションはスキップできます。
これは一度だけ行うセットアップ手順です。権限を設定した後は、任意の数のカスタムチェックポイントをバケットにアップロードし、デプロイで直接使用できます。
サービスアカウントの確認
サービスアカウントの情報は JSON ファイルとして提供されます。client_email フィールドを確認してください。これが、バケットへの読み取りアクセス権を必要とする ID です。例:Storage Object Viewer ロールの付与
SambaStack がカスタムチェックポイントにアクセスできるようにするには、サービスアカウントに対して、バケットの Storage Object Viewer ロールを付与します。これにより、書き込みや変更を許可せず、オブジェクトへの読み取り専用アクセスのみが可能になります。Google Cloud Console を使用する場合:- Google Cloud Console を開きます。
- Storage → Buckets に移動し、使用するバケットを選択します。
- Permissions タブに移動します。
- + Add principal をクリックします。
- 「New principals」フィールドに、サービスアカウントの
client_emailを入力します。 - 「Role」ドロップダウンで Cloud Storage → Storage Object Viewer を選択します。
- Save をクリックします。
<BUCKET_NAME>– GCS バケットの名前<SERVICE_ACCOUNT_EMAIL>– サービスアカウントの JSON に記載されたclient_emailの値<PROJECT_ID>– バケットを所有する Google Cloud プロジェクト
変換済みチェックポイントのアップロード
NFS
クラスターに NFS がマウントされている場合は、変換済みチェックポイントが NFS に移動され、クラスターからアクセスできることを確認してください。Google Cloud Storage
Google Cloud Storage (GCS) を使用している場合は、チェックポイントの変換後、変換済みチェックポイントのファイルを含むディレクトリを GCS バケットにアップロードします。このステップは、チェックポイントのサイズによっては時間がかかることがあります。
- Google Cloud Console を開きます。
- Storage → Buckets に移動し、カスタムチェックポイント用に設定したバケットを選択します。
- Upload folder (または、構成によっては Upload files) をクリックします。
- 変換済みチェックポイントのアーティファクトを含むディレクトリを選択します。
- アップロードの完了を待ちます。ディレクトリ構造はそのまま維持される必要があります。
モデルマニフェストによるチェックポイントの登録
モデルマニフェスト (Model Manifest) を作成して、チェックポイントを登録します。モデルマニフェストには、API リクエストで使用する名前、対応言語、チェックポイントの説明など、チェックポイントに関する情報が保存されます。
モデルマニフェストの構造
以下はモデルマニフェストの例です。name フィールド (例: My-Custom-Llama3.1-8B) が、以降のステップおよび API リクエストで使用する名前になります。tokenizer フィールドの設定
tokenizer フィールドには、カスタムチェックポイントに使用したベースモデルを設定できます。例えば、カスタムチェックポイントが Meta-Llama-3.1-70B-Instruct からファインチューニングされたものである場合、トークナイザーのパスを次のように設定します。モデルマニフェストの tokenizer フィールドは、生成の前に入力のチェックを実行してシーケンス長の要件を計算するためにのみ使用されます。
モデルマニフェストの適用
モデルマニフェストを作成したら、次のコマンドで適用します。デプロイ用 Bundle でのチェックポイントの参照
カスタムチェックポイントのデプロイは、SambaStack で標準モデルをデプロイする場合と全体として同じワークフローに従います。最も簡単な方法は、カスタムチェックポイントと同じモデルアーキテクチャを使用する既存の Bundle Template から始めて、関連するフィールドをカスタムアーティファクトを指すように変更することです。
Bundle Template やモデルデプロイの概念、ユースケースに応じたテンプレートの選び方がわからない場合は、バンドルのデプロイのページをご参照ください。
Bundle 構造の理解
Bundle 定義の中で変更するオブジェクトは以下のとおりです。checkpoints– チェックポイントのエイリアスと、その GCS ソースパスを定義しますmodels– モデル名をチェックポイントとテンプレートにマッピングします
Meta-Llama-3.1-8B-Instruct モデルおよび Meta-Llama-3.1-70B-Instruct モデル用の Bundle の例です。checkpoints セクションの更新
spec.checkpoints では以下を行います。- チェックポイントのキーを、カスタムチェックポイント用の名前 (エイリアス) に変更する
sourceフィールドを、変換済みチェックポイントのディレクトリの GCS パスに更新する- ファインチューニング済みチェックポイントがツール利用向けに構成されているかどうかに応じて、
toolSupportをtrueまたはfalseに設定する
spec.checkpoints.source には、Google Cloud Storage のパス (gs://) または NFS のパス (nfs://) を指定できます。上の例では、/nfsdata はサービング Pod 内で NFS がマウントされているパスです。models セクションの更新
spec.models では以下を行います。- モデルのキーを、モデルマニフェストで定義した名前に変更する (これが推論 API の呼び出しで使用する名前になります)
checkpointフィールドを、上で定義したエイリアスに設定するtemplateは元のモデルテンプレートのままにする
template フィールドはベースモデルを反映している必要があります。例えば、カスタムチェックポイントが Meta-Llama-3.3-70B-Instruct からファインチューニングされたものであれば、template フィールドは Meta-Llama-3.3-70B-Instruct にします。Bundle の適用
Bundle 構成を更新したら、適用します。デプロイの確認
Bundle を適用したら、カスタムチェックポイントのデプロイが成功したことを確認します。-
デプロイ状態の確認:
-
モデルが利用可能であることの確認:
- カスタムモデル名を使用して、サンプルの推論リクエストでテストします。 SambaNova SDK、OpenAI 互換ライブラリ、CURL を使用した推論リクエストの例については、開発者向けクイックスタートガイドをご参照ください。
トラブルシューティング
よくある問題
GCS アクセスの確認
権限の問題が疑われる場合は、サービスアカウントがチェックポイントにアクセスできることを確認してください。次のステップ
- 投機的デコーディングを使用してカスタムチェックポイントをデプロイするには、投機的デコーディングによるデプロイをご参照ください。
- 監視とモニタリングについては、SambaStack の監視をご参照ください。
- カスタムチェックポイントがベースモデルと異なるチャットテンプレートやツール呼び出しの出力形式を使用する場合は、クライアント側でのプロンプト整形と出力解析の方法について、開発者ガイドのカスタムチャットテンプレートと出力解析をご参照ください。

