|
|
@@ -2,7 +2,7 @@
|
|
|
|
|
|
本文档介绍如何使用 Helm 在 Kubernetes 集群中部署 MASS-Base 平台。Helm 方式适合生产环境和大规模部署。
|
|
|
|
|
|
-> **注意:** Kubernetes 部署模式下,内置 Higress 网关目前为实验性阶段,详见[限制](#限制)部分。
|
|
|
+> **注意:** Kubernetes 部署模式下,内嵌 Higress 网关目前为实验性阶段,详见[限制](#限制)部分。
|
|
|
|
|
|
## 前置要求
|
|
|
|
|
|
@@ -56,7 +56,7 @@ cd maas-base/charts
|
|
|
|
|
|
## 4. 部署 MASS-Base
|
|
|
|
|
|
-### 4.1 默认部署(内置 Higress 网关)
|
|
|
+### 4.1 默认部署(内嵌 Higress 网关)
|
|
|
|
|
|
```bash
|
|
|
helm install -n gpustack-system gpustack ./gpustack --create-namespace
|
|
|
@@ -64,7 +64,7 @@ helm install -n gpustack-system gpustack ./gpustack --create-namespace
|
|
|
|
|
|
此命令会部署以下组件:
|
|
|
|
|
|
-- **`gpustack-server`** — StatefulSet(1 副本),含嵌入式 PostgreSQL
|
|
|
+- **`gpustack-server`** — StatefulSet(1 副本),含内嵌 PostgreSQL
|
|
|
- **`gpustack-worker`** — DaemonSet,在每个 GPU 节点上运行 Worker
|
|
|
- **`higress`** — Higress 网关(子 Chart),负责 API 路由和负载均衡
|
|
|
- **`higress-plugins`** — Higress 插件服务 Deployment
|
|
|
@@ -72,7 +72,7 @@ helm install -n gpustack-system gpustack ./gpustack --create-namespace
|
|
|
|
|
|
### 4.2 使用已安装的 Higress
|
|
|
|
|
|
-如果集群中已有 Higress,跳过内置网关部署:
|
|
|
+如果集群中已有 Higress,跳过内嵌网关部署:
|
|
|
|
|
|
```bash
|
|
|
helm install -n gpustack-system gpustack ./gpustack --create-namespace \
|
|
|
@@ -137,7 +137,7 @@ kubectl port-forward -n gpustack-system svc/gpustack-server 8080:80
|
|
|
|
|
|
### 6.1 使用外部数据库
|
|
|
|
|
|
-推荐生产环境使用外部 PostgreSQL 而非内置数据库:
|
|
|
+推荐生产环境使用外部 PostgreSQL 而非内嵌数据库:
|
|
|
|
|
|
```bash
|
|
|
helm install -n gpustack-system gpustack ./gpustack --create-namespace \
|
|
|
@@ -296,7 +296,7 @@ helm uninstall -n gpustack-system gpustack
|
|
|
## 9. 限制
|
|
|
|
|
|
- **Server 不支持多副本:** Server 以 StatefulSet 部署,目前仅支持 1 个副本
|
|
|
-- **内置 PostgreSQL:** 默认使用内置嵌入式 PostgreSQL,推荐使用 `server.externalDatabaseURL` 配置外部数据库
|
|
|
+- **内嵌 PostgreSQL:** 默认使用内嵌嵌入式 PostgreSQL,推荐使用 `server.externalDatabaseURL` 配置外部数据库
|
|
|
- **PVC 要求:** StatefulSet 使用 `volumeClaimTemplates`(默认 10Gi),需配置默认 StorageClass;或使用 `server.dataVolume.hostPath` 指定 hostPath
|
|
|
- **Higress 插件依赖:** Higress 网关重启时会从 `gpustack/higress-plugins` Deployment 下载插件,该服务不可用时会阻塞网关启动
|
|
|
- **现有 Ingress 控制器冲突:** 如果集群中已有其他 Ingress 控制器,需设置 `higress-core.enabled=false` 并配置 `gateway.ingressClassname`
|