Docker によるアップグレード
Docker ベースの GPUStack は、新しいイメージを取得してコンテナーを再作成することでアップグレードできます。
以下のアップグレード手順は、GPUStack v2.0 以降にのみ適用されます。
v0.7 より前のインストールについては、移行ガイドをご覧ください。
注記
-
アップグレード時は、最初に GPUStack サーバー、次にワーカーをアップグレードします。
-
main(開発版)またはリリース候補(rc)版には破壊的変更が含まれる場合があるため、これらのバージョンから、またはこれらへのアップグレードは行わないでください。main 版や rc 版を試す場合は、新規にインストールしてください。
警告
最初にバックアップ: アップグレードを始める前に、データベースのバックアップを強く推奨します。
組み込み PostgreSQL を使用するデフォルトの構成では、GPUStack サーバーを停止し、コンテナー内の次の PostgreSQL データベースディレクトリをバックアップします。
外部データベースを使用する場合は、そのデータベースプロバイダーのバックアップ手順に従ってください。
最初にサーバー、次にワーカーをアップグレードします。サーバーは、新しいイメージ(特定のバージョンタグまたは latest タグ)を取得し、古いコンテナーを削除して、以前と同じ引数とボリュームで新しいイメージのコンテナーを起動することでアップグレードします。
サーバーのアップグレード
ワーカーのアップグレード
新しいバージョンのサーバーが起動したら、各クラスターのワーカーをアップグレードします。Docker、Kubernetes、クラウドクラスターの手順は、クラスターのデプロイメントのアップグレードをご覧ください。
DP Attention を使用する SGLang のデプロイメントでは、以前のバージョンのポート予約が不完全な場合があります。参加するすべてのワーカーをアップグレードした後、デプロイメントで Restart Model を実行するか、再デプロイして、必要なポートがすべて予約された新しいインスタンスを作成してください。エンジンプロセスまたはワーカーの再起動だけでは、既存のインスタンスのポートが維持されます。
カスタム run_command テンプレートを使用する場合は、モデルまたはロールの backend_parameters に DP Attention のオプションを指定し、起動前のポート計画で必要な範囲を予約できるようにしてください。ワーカーはテンプレートの変数を展開した後のコマンドを確認し、公開済みのポートを変更せずに予約の不足を報告します。
Docker Compose によるアップグレード
クローンしたリポジトリから Docker Compose でデプロイした場合は、新しいリリースタグをチェックアウトし、更新したイメージでコンテナーを再作成します。