feat: 添加 GitHub Actions 自动构建 Docker 镜像功能

Author: MG-Duan

.dockerignore

@@ -0,0 +1,33 @@
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Documentation
+README.md
+docs/
+img/
+*.md
+
+# Docker
+docker-compose*.yml
+.dockerignore
+
+# Deployment scripts
+deploy-scripts/
+
+# Logs
+*.log
+logs/
+
+# Environment
+.env
+.env.*

.env.example

@@ -0,0 +1,31 @@
+# Django 配置
+DJANGO_SECRET_KEY=your-secret-key-here-change-in-production
+DJANGO_DEBUG=False
+DJANGO_ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
+DJANGO_CORS_ALLOWED_ORIGINS=http://localhost:80,https://your-domain.com
+
+# Django 管理员账号（首次启动时自动创建）
+DJANGO_ADMIN_USERNAME=admin
+DJANGO_ADMIN_EMAIL=admin@example.com
+DJANGO_ADMIN_PASSWORD=admin123456
+
+# 数据库配置（如果使用 PostgreSQL）
+# DATABASE_URL=postgresql://user:password@postgres:5432/wharttest
+
+# MCP 服务配置
+
+# MS MCP API 配置（如需使用 MS 测试平台集成，请取消注释并填写正确的密钥）
+# 注意：MS_SECRET_KEY 必须是 16、24 或 32 字节长度
+# MS_API_HOST=http://ms.example.com
+# MS_ACCESS_KEY=your_16byte_key1
+# MS_SECRET_KEY=your_16byte_key2
+
+# WHartTest Tools 配置
+# Docker 环境使用: http://backend:8000
+# 本地开发使用: http://localhost:8000
+WHARTTEST_BACKEND_URL=http://backend:8000
+
+# WHartTest API Key
+# 请在 WHartTest 平台的"API密钥管理"页面生成 API Key，然后填写到这里
+# 登录后访问：设置 -> API密钥管理 -> 创建新密钥
+WHARTTEST_API_KEY=your_api_key_here

.github/workflows/docker-build.yml

@@ -0,0 +1,117 @@
+name: Build and Push Docker Images
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_BACKEND: ghcr.io/${{ github.repository_owner }}/wharttest-backend
+  IMAGE_FRONTEND: ghcr.io/${{ github.repository_owner }}/wharttest-frontend
+  IMAGE_MCP: ghcr.io/${{ github.repository_owner }}/wharttest-mcp
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata for backend
+        id: meta-backend
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE_BACKEND }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Extract metadata for frontend
+        id: meta-frontend
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE_FRONTEND }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Extract metadata for MCP
+        id: meta-mcp
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE_MCP }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push backend image
+        uses: docker/build-push-action@v5
+        with:
+          context: ./WHartTest_Django
+          file: ./WHartTest_Django/Dockerfile
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta-backend.outputs.tags }}
+          labels: ${{ steps.meta-backend.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Build and push frontend image
+        uses: docker/build-push-action@v5
+        with:
+          context: ./WHartTest_Vue
+          file: ./WHartTest_Vue/Dockerfile
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta-frontend.outputs.tags }}
+          labels: ${{ steps.meta-frontend.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Build and push MCP image
+        uses: docker/build-push-action@v5
+        with:
+          context: ./WHartTest_MCP
+          file: ./WHartTest_MCP/Dockerfile
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta-mcp.outputs.tags }}
+          labels: ${{ steps.meta-mcp.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Image digest
+        run: |
+          echo "Backend: ${{ steps.meta-backend.outputs.tags }}"
+          echo "Frontend: ${{ steps.meta-frontend.outputs.tags }}"
+          echo "MCP: ${{ steps.meta-mcp.outputs.tags }}"

README.md

@@ -8,6 +8,34 @@ WHartTest 是一个基于 Django REST Framework 构建的AI驱动测试自动化
 ## 文档
 详细文档请访问：https://mgdaaslab.github.io/WHartTest/
 
+## 快速开始
+
+### Docker 部署（推荐）
+
+#### 使用预构建镜像（无需本地构建）
+```bash
+# 1. 克隆仓库
+git clone https://github.com/MG-Duan/WHartTest.git
+cd WHartTest
+
+# 2. 配置环境变量
+cp .env.example .env
+# 编辑 .env 文件，设置必要的环境变量
+
+# 3. 使用预构建镜像启动
+docker-compose -f docker-compose.prod.yml up -d
+```
+
+#### 本地构建镜像（开发环境）
+```bash
+# 使用默认配置，会在本地构建镜像
+docker-compose up -d
+```
+
+详细的部署说明请参考：
+- [GitHub 自动构建部署指南](./docs/github-docker-deployment.md)
+- [完整部署文档](https://mgdaaslab.github.io/WHartTest/)
+
 ## 页面展示
 
 | | |

WHartTest_Django/.dockerignore

@@ -1,23 +1,53 @@
-db.sqlite3
-*.sqlite3
-chat_history.sqlite
-chat_history.sqlite-shm
-chat_history.sqlite-wal
+# Python
 __pycache__/
-*.pyc
-.env
-.DS_Store
-# 知识库数据
-knowledge/chroma_db/
-knowledge/documents/
-# 缓存目录（保留模型文件）
-.cache/pip/
-.cache/torch/
-.cache/transformers/checkpoints/
-# 用户上传文件
-media/
-# 旧版知识库数据
-knowledge_bases/
-# 日志文件
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+
+# Django
 *.log
-logs/
+db.sqlite3
+db.sqlite3-journal
+media/
+staticfiles/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Documentation
+README.md
+docs/
+*.md
+
+# Tests
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose*.yml

WHartTest_Django/Dockerfile

@@ -1,32 +1,39 @@
-FROM python:3.12-slim
+# 使用 Python 3.11 官方镜像作为基础镜像
+FROM python:3.11-slim
 
+# 设置工作目录
 WORKDIR /app
 
-# 设置Hugging Face缓存目录
-ENV HF_HOME=/app/.cache/huggingface \
-    HF_HUB_CACHE=/app/.cache/huggingface/hub
+# 设置环境变量
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
 
-# 使用国内镜像源加速
-RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list.d/debian.sources
+# 安装系统依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/*
 
-# 安装系统依赖（SQLite开发库）
-RUN apt-get update && apt-get install -y libsqlite3-dev
+# 安装 uv
+RUN pip install uv
 
-# 复制依赖文件并安装
+# 复制 requirements 文件
 COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
+
+# 使用 uv 安装 Python 依赖
+RUN uv pip install --system -r requirements.txt
 
 # 复制项目文件
 COPY . .
 
-# 复制已有的模型缓存目录（如果存在）
-COPY .cache/huggingface /app/.cache/huggingface
+# 创建必要的目录
+RUN mkdir -p media static nltk_data
 
+# 暴露端口
 EXPOSE 8000
 
-# 设置默认超级用户环境变量
-ENV DJANGO_SUPERUSER_USERNAME=admin \
-    DJANGO_SUPERUSER_PASSWORD=123456 \
-    DJANGO_SUPERUSER_EMAIL=admin@qq.com
-
-CMD ["sh", "-c", "python manage.py migrate && python manage.py createsuperuser --noinput || true && python manage.py runserver 0.0.0.0:8000"]
+# 启动命令
+CMD ["bash", "-c", "python manage.py migrate --noinput && python manage.py init_admin && python manage.py runserver 0.0.0.0:8000"]

WHartTest_Django/accounts/management/commands/init_admin.py

@@ -0,0 +1,37 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth import get_user_model
+import os
+
+User = get_user_model()
+
+class Command(BaseCommand):
+    help = '创建默认管理员账号'
+
+    def handle(self, *args, **options):
+        # 从环境变量获取管理员信息
+        admin_username = os.environ.get('DJANGO_ADMIN_USERNAME', 'admin')
+        admin_email = os.environ.get('DJANGO_ADMIN_EMAIL', 'admin@example.com')
+        admin_password = os.environ.get('DJANGO_ADMIN_PASSWORD', 'admin123456')
+
+        # 检查管理员是否已存在
+        if User.objects.filter(username=admin_username).exists():
+            self.stdout.write(
+                self.style.WARNING(f'管理员账号 "{admin_username}" 已存在，跳过创建')
+            )
+            return
+
+        # 创建管理员账号
+        User.objects.create_superuser(
+            username=admin_username,
+            email=admin_email,
+            password=admin_password
+        )
+        
+        self.stdout.write(
+            self.style.SUCCESS(
+                f'成功创建管理员账号:\n'
+                f'  用户名: {admin_username}\n'
+                f'  邮箱: {admin_email}\n'
+                f'  密码: {admin_password}'
+            )
+        )