コンテンツにスキップ

Docker によるアップグレード

Docker ベースの GPUStack は、新しいイメージを取得してコンテナーを再作成することでアップグレードできます。

以下のアップグレード手順は、GPUStack v2.0 以降にのみ適用されます。

v0.7 より前のインストールについては、移行ガイドをご覧ください。

注記

  1. アップグレード時は、最初に GPUStack サーバー、次にワーカーをアップグレードします。

  2. main（開発版）またはリリース候補（rc）版には破壊的変更が含まれる場合があるため、これらのバージョンから、またはこれらへのアップグレードは行わないでください。main 版や rc 版を試す場合は、新規にインストールしてください。

警告

最初にバックアップ： アップグレードを始める前に、データベースのバックアップを強く推奨します。

組み込み PostgreSQL を使用するデフォルトの構成では、GPUStack サーバーを停止し、コンテナー内の次の PostgreSQL データベースディレクトリをバックアップします。

1
/var/lib/gpustack/postgresql/data

外部データベースを使用する場合は、そのデータベースプロバイダーのバックアップ手順に従ってください。

最初にサーバー、次にワーカーをアップグレードします。サーバーは、新しいイメージ（特定のバージョンタグまたは latest タグ）を取得し、古いコンテナーを削除して、以前と同じ引数とボリュームで新しいイメージのコンテナーを起動することでアップグレードします。

サーバーのアップグレード

1
2
3
4
5
6
7
8
9
docker pull gpustack/gpustack:latest  # or: docker pull gpustack/gpustack:vx.y.z

docker stop gpustack
docker rm gpustack

docker run -d --name gpustack \
  ... \
  gpustack/gpustack:latest
  ...

ワーカーのアップグレード

新しいバージョンのサーバーが起動したら、各クラスターのワーカーをアップグレードします。Docker、Kubernetes、クラウドクラスターの手順は、クラスターのデプロイメントのアップグレードをご覧ください。

Docker Compose によるアップグレード

クローンしたリポジトリから Docker Compose でデプロイした場合は、新しいリリースタグをチェックアウトし、更新したイメージでコンテナーを再作成します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
cd gpustack

# Fetch the tags and check out the target stable release
git fetch --tags
git checkout <new-tag>   # e.g. vx.y.z

cd docker-compose

# Pull the new image and recreate the containers
sudo docker compose -f docker-compose.server.yaml pull
sudo docker compose -f docker-compose.server.yaml up -d