feat(docs,ci): 完善云上部署文档与 Docker CI 流程 (#320)

- release workflow 新增 Docker 镜像构建推送至 GHCR
- 重写 examples/cloud/GUIDE.md 云上部署指南，补充架构概览、systemd/Docker/Helm 三种部署方式、多租户管理、FAQ 等章节
- ov.conf.example 占位符改为 <your-xxx> 格式，移除 rerank 配置
- 中英文部署文档（docs/zh|en/guides/03-deployment.md）对齐：Docker 改用 GHCR 预构建镜像，Kubernetes 改用 Helm chart，并引用 GUIDE.md

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

.github/workflows/release.yml

@@ -153,3 +153,51 @@ jobs:
         VERSION=$(ls dist/*.whl | head -n 1 | xargs basename | cut -d- -f2)
         echo "Successfully published to PyPI with version: $VERSION"
         echo "::notice::Successfully published to PyPI with version: $VERSION"
+
+  docker:
+    name: Build and Push Docker Image
+    needs: [build, permission-check]
+    if: >-
+      needs.permission-check.outputs.allowed == 'true' &&
+      github.event_name == 'release'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            OPENVIKING_VERSION=${{ github.event.release.tag_name }}

docs/en/guides/03-deployment.md

@@ -197,83 +197,38 @@ curl http://localhost:1933/api/v1/fs/ls?uri=viking:// \
 
 ### Docker
 
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-COPY . .
-RUN pip install -e .
-EXPOSE 1933
-CMD ["python", "-m", "openviking", "serve", "--config", "/etc/openviking/ov.conf"]
+OpenViking provides pre-built Docker images published to GitHub Container Registry:
+
+```bash
+docker run -d \
+  --name openviking \
+  -p 1933:1933 \
+  -v ~/.openviking/ov.conf:/app/ov.conf \
+  -v /var/lib/openviking/data:/app/data \
+  --restart unless-stopped \
+  ghcr.io/volcengine/openviking:main
 ```
 
+You can also use Docker Compose with the `docker-compose.yml` provided in the project root:
+
 ```bash
-docker build -t openviking .
-docker run -d -p 1933:1933 \
-  -v /path/to/ov.conf:/etc/openviking/ov.conf:ro \
-  -v /data/openviking:/data/openviking \
-  openviking
+docker compose up -d
 ```
 
-### Kubernetes
-
-```yaml
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: openviking
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: openviking
-  template:
-    metadata:
-      labels:
-        app: openviking
-    spec:
-      containers:
-        - name: openviking
-          image: openviking:latest
-          ports:
-            - containerPort: 1933
-          volumeMounts:
-            - name: config
-              mountPath: /etc/openviking
-              readOnly: true
-            - name: data
-              mountPath: /data/openviking
-          livenessProbe:
-            httpGet:
-              path: /health
-              port: 1933
-            initialDelaySeconds: 5
-            periodSeconds: 10
-          readinessProbe:
-            httpGet:
-              path: /ready
-              port: 1933
-            initialDelaySeconds: 10
-            periodSeconds: 15
-      volumes:
-        - name: config
-          configMap:
-            name: openviking-config
-        - name: data
-          persistentVolumeClaim:
-            claimName: openviking-data
----
-apiVersion: v1
-kind: Service
-metadata:
-  name: openviking
-spec:
-  selector:
-    app: openviking
-  ports:
-    - port: 1933
-      targetPort: 1933
+To build the image yourself: `docker build -t openviking:latest .`
+
+### Kubernetes + Helm
+
+The project provides a Helm chart located at `examples/k8s-helm/`:
+
+```bash
+helm install openviking ./examples/k8s-helm \
+  --set openviking.config.embedding.dense.api_key="YOUR_API_KEY" \
+  --set openviking.config.vlm.api_key="YOUR_API_KEY"
 ```
 
+For a detailed cloud deployment guide (including Volcengine TOS + VikingDB + Ark configuration), see the [Cloud Deployment Guide](../../../examples/cloud/GUIDE.md).
+
 ## Health Checks
 
 | Endpoint | Auth | Purpose |

docs/zh/guides/03-deployment.md

@@ -191,83 +191,38 @@ curl http://localhost:1933/api/v1/fs/ls?uri=viking:// \
 
 ### Docker
 
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-COPY . .
-RUN pip install -e .
-EXPOSE 1933
-CMD ["python", "-m", "openviking", "serve", "--config", "/etc/openviking/ov.conf"]
+OpenViking 提供预构建的 Docker 镜像，发布在 GitHub Container Registry：
+
+```bash
+docker run -d \
+  --name openviking \
+  -p 1933:1933 \
+  -v ~/.openviking/ov.conf:/app/ov.conf \
+  -v /var/lib/openviking/data:/app/data \
+  --restart unless-stopped \
+  ghcr.io/volcengine/openviking:main
 ```
 
+也可以使用 Docker Compose，项目根目录提供了 `docker-compose.yml`：
+
 ```bash
-docker build -t openviking .
-docker run -d -p 1933:1933 \
-  -v /path/to/ov.conf:/etc/openviking/ov.conf:ro \
-  -v /data/openviking:/data/openviking \
-  openviking
+docker compose up -d
 ```
 
-### Kubernetes
-
-```yaml
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: openviking
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: openviking
-  template:
-    metadata:
-      labels:
-        app: openviking
-    spec:
-      containers:
-        - name: openviking
-          image: openviking:latest
-          ports:
-            - containerPort: 1933
-          volumeMounts:
-            - name: config
-              mountPath: /etc/openviking
-              readOnly: true
-            - name: data
-              mountPath: /data/openviking
-          livenessProbe:
-            httpGet:
-              path: /health
-              port: 1933
-            initialDelaySeconds: 5
-            periodSeconds: 10
-          readinessProbe:
-            httpGet:
-              path: /ready
-              port: 1933
-            initialDelaySeconds: 10
-            periodSeconds: 15
-      volumes:
-        - name: config
-          configMap:
-            name: openviking-config
-        - name: data
-          persistentVolumeClaim:
-            claimName: openviking-data
----
-apiVersion: v1
-kind: Service
-metadata:
-  name: openviking
-spec:
-  selector:
-    app: openviking
-  ports:
-    - port: 1933
-      targetPort: 1933
+如需自行构建镜像：`docker build -t openviking:latest .`
+
+### Kubernetes + Helm
+
+项目提供了 Helm chart，位于 `examples/k8s-helm/`：
+
+```bash
+helm install openviking ./examples/k8s-helm \
+  --set openviking.config.embedding.dense.api_key="YOUR_API_KEY" \
+  --set openviking.config.vlm.api_key="YOUR_API_KEY"
 ```
 
+详细的云上部署指南（包括火山引擎 TOS + VikingDB + 方舟配置）请参考 [云上部署指南](../../../examples/cloud/GUIDE.md)。
+
 ## 健康检查
 
 | 端点 | 认证 | 用途 |