feat(ci): 添加 Docker 镜像构建和发布功能

- 在 GitHub Actions 工作流中增加 Docker 构建和推送步骤
- 配置 Docker 权限以支持包写入操作
- 添加 Docker 镜像元数据提取和标签生成
- 更新 .env.example 中的镜像路径配置
- 添加 Docker Compose 配置文件用于本地部署
- 创建完整的 README.md 文档说明 Docker 使用方法
- 配置自动化的 Docker 镜像发布流程到 GHCR

Author: nukewarrior

.env.example

@@ -1,4 +1,4 @@
-GCS_BINARY_PATH=./dist/gcs-linux-x86_64
+GCS_IMAGE=ghcr.io/<your-org-or-user>/<your-repo>:latest
 GCS_WORKDIR_HOST=./gcs_workspace
 GCS_PORT=8765
 GCS_WORKERS=8

.github/workflows/release.yml

@@ -7,6 +7,7 @@ on:
 
 permissions:
   contents: write
+  packages: write
 
 jobs:
   build:
@@ -83,3 +84,56 @@ jobs:
         with:
           generate_release_notes: true
           files: release-assets/*
+
+  docker:
+    name: Build And Publish Docker Image
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download Linux Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: linux-x86_64
+          path: dist
+
+      - name: Ensure Binary Is Executable
+        run: chmod +x dist/gcs-linux-x86_64
+
+      - name: Smoke Test Docker Image
+        run: |
+          docker build -t gcs-smoke:latest .
+          docker run --rm gcs-smoke:latest --version
+          docker run --rm gcs-smoke:latest search --help
+          docker run --rm gcs-smoke:latest serve --help
+
+      - name: Setup Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login To GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker Metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=ref,event=tag
+            type=raw,value=latest
+
+      - name: Build And Push Docker Image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./Dockerfile
+          platforms: linux/amd64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

README.md

@@ -209,15 +209,15 @@
 dist/gcs
 ```
 
-## Docker Compose 直接运行编译后二进制
+## Docker Compose 直接运行发布镜像
 
-适用于已经拿到 Linux 可执行文件的场景，例如 GitHub Release 里的 `gcs-linux-x86_64`。
+默认推荐直接使用 GitHub Action 发布到 GHCR 的镜像，不需要先下载二进制。
 
-1. 准备二进制和环境变量：
+1. 准备环境变量：
 
 ```bash
 cp .env.example .env
-# 把 Linux 二进制放到 .env 里的 GCS_BINARY_PATH，默认是 ./dist/gcs-linux-x86_64
+# 把 GCS_IMAGE 改成仓库实际发布出来的 GHCR 镜像地址
 ```
 
 2. 启动 `serve`：
@@ -234,10 +234,9 @@ docker compose logs -f gcs-serve
 
 说明：
 
-- `compose.yaml` 会直接挂载并执行编译后的二进制，不会在容器里重新安装 Python 依赖或重新构建
-- `GCS_BINARY_PATH` 必须指向 Linux 二进制，不能使用当前机器打出来的 macOS `dist/gcs`
+- `compose.yaml` 默认直接拉取 GHCR 镜像，别人只需要填 `.env` 就可以启动
 - `GCS_WORKDIR_HOST` 会映射到容器内 `/data`，其中包含 SQLite、导出文件和 `serve` 持久化 PAT，应放在私有目录
-- 如果使用 arm64 Linux 二进制，请同时修改 `GCS_BINARY_PATH` 和 `GCS_DOCKER_PLATFORM`
+- 当前 GitHub Action 发布的是 `linux/amd64` 镜像；在 Apple Silicon 上可以继续用 Docker Desktop 模拟运行
 
 ## GitHub Actions 自动发布
 
@@ -250,6 +249,7 @@ docker compose logs -f gcs-serve
   - macOS Apple Silicon（arm64）
   - Linux x86_64
   - Windows x86_64
+- 自动构建并推送 Docker 镜像到 GitHub Container Registry（GHCR）
 - 自动创建 GitHub Release 并上传二进制附件
 
 触发示例：

compose.yaml

@@ -1,10 +1,9 @@
 services:
   gcs-serve:
-    image: debian:bookworm-slim
+    image: ${GCS_IMAGE:?set GCS_IMAGE in .env or your shell}
     platform: ${GCS_DOCKER_PLATFORM:-linux/amd64}
     restart: unless-stopped
     init: true
-    working_dir: /srv/gcs
     environment:
       GCS_ADMIN_TOKEN: ${GCS_ADMIN_TOKEN:?set GCS_ADMIN_TOKEN in .env or your shell}
       GCS_GITLAB_URL: ${GCS_GITLAB_URL:-}
@@ -14,32 +13,6 @@ services:
     ports:
       - "${GCS_PORT:-8765}:${GCS_PORT:-8765}"
     volumes:
-      - type: bind
-        source: ${GCS_BINARY_PATH:-./dist/gcs-linux-x86_64}
-        target: /binary/gcs
-        read_only: true
       - type: bind
         source: ${GCS_WORKDIR_HOST:-./gcs_workspace}
         target: /data
-    command:
-      - /bin/sh
-      - -lc
-      - |
-        set -eu
-        cp /binary/gcs /tmp/gcs
-        chmod +x /tmp/gcs
-        if [ -n "${GCS_GITLAB_URL:-}" ]; then
-          exec /tmp/gcs serve \
-            --workdir "${GCS_WORKDIR}" \
-            --admin-token "${GCS_ADMIN_TOKEN}" \
-            --host 0.0.0.0 \
-            --port "${GCS_PORT}" \
-            --gitlab-url "${GCS_GITLAB_URL}" \
-            --workers "${GCS_WORKERS}"
-        fi
-        exec /tmp/gcs serve \
-          --workdir "${GCS_WORKDIR}" \
-          --admin-token "${GCS_ADMIN_TOKEN}" \
-          --host 0.0.0.0 \
-          --port "${GCS_PORT}" \
-          --workers "${GCS_WORKERS}"