跳转至

通过 Helm 升级

对于基于 Kubernetes 安装的 GPUStack,可以使用 helm upgrade 升级。

以下升级说明仅适用于 GPUStack v2.2.0 及更高版本,这是首个支持通过 Helm 部署的版本。

说明

使用 Higress 在 Kubernetes 上部署和升级 GPUStack 目前属于实验性功能。

警告

先备份: 升级之前,强烈建议备份数据库。

如果使用内置的内嵌 PostgreSQL 数据库,其数据位于 GPUStack Server 的 PVC 中。PVC 名称为 gpustack-data-dir-<release-name>-server-0,例如默认 gpustack-server Release 对应 gpustack-data-dir-gpustack-server-server-0。该 PVC 在 GPUStack Server Pod 内挂载到 /var/lib/gpustack,内嵌 PostgreSQL 数据目录位于挂载路径下的 postgresql/data。升级前请备份。

如果使用外部数据库(server.externalDatabaseURL),请改用数据库提供方的备份流程。

升级 Release

始终通过 --version <chart-version> 固定目标版本,以确保升级到已知且可重复部署的版本(Chart 版本与 GPUStack 发布版本对应,例如 2.2.0),并通过传入安装时使用的相同 -f values.yaml 和/或 --set 参数复用配置,也可以使用 --reuse-values 保留之前应用的值。release 名称取决于安装时遵循的文档——旧版文档使用 gpustack,当前文档使用 gpustack-server——因此下面的命令会从命名空间内各 StatefulSet 的 meta.helm.sh/release-name 注解中自动推导该名称(通过 GPUStack 集群注册产生的 worker-only release 不拥有 StatefulSet,会被匹配模式排除),且只有在恰好找到一个匹配的 release 时才会执行升级:

1
2
3
4
5
6
7
8
9
RELEASE_NAME=$(kubectl get statefulset -n gpustack-system \
  -o jsonpath='{range .items[*]}{.metadata.annotations.meta\.helm\.sh/release-name}{"\n"}{end}' \
  | grep -E '^gpustack(-server)?$' | sort -u)
[ "$(printf '%s\n' "$RELEASE_NAME" | grep -c .)" -eq 1 ] \
  || { echo "expected one GPUStack server release in gpustack-system, got: '$RELEASE_NAME'" >&2; false; } \
  && helm upgrade "$RELEASE_NAME" oci://registry-1.docker.io/gpustack/gpustack-chart \
    --namespace gpustack-system \
    --version <chart-version> \
    -f values.yaml

警告

省略 --version 时,Helm 会自动选择最新稳定 Chart 版本。升级时应避免这样做,因为您无法控制最终升级到哪个版本。始终使用 --version 指定目标发布版本。

GPUStack Server 和 Worker 的升级顺序

GPUStack Server 部署为 StatefulSet,Chart 管理的 Worker 部署为 DaemonSet,因此 Release 升级时,两者都会滚动更新到新镜像。由于 GPUStack Server 和 Worker 属于同一个 Release,单次 helm upgrade 无法保证“先 GPUStack Server,后 Worker”的顺序。如果环境要求严格顺序,请先等待 GPUStack Server Pod 就绪,再允许 Worker Pod 滚动更新:

kubectl rollout status statefulset/${RELEASE_NAME}-server -n gpustack-system

通过 GPUStack 集群在 Chart 之外注册的 Worker,例如通过界面添加的 Docker 或 Kubernetes 集群,不受此 Helm Release 管理,必须按照升级集群部署中的步骤升级。