🚀 主要功能: - 完善后端API服务层,实现完整的CRUD操作 - 开发管理后台所有核心页面 (仪表板、照片、分类、标签、用户、设置) - 完成前后端完全集成,所有API接口正常对接 - 配置完整的CI/CD流水线,支持自动化部署 🎯 后端完善: - 实现PhotoService, CategoryService, TagService, UserService - 添加完整的API处理器和路由配置 - 支持Docker容器化部署 - 添加数据库迁移和健康检查 🎨 管理后台完成: - 仪表板: 实时统计数据展示 - 照片管理: 完整的CRUD操作,支持批量处理 - 分类管理: 树形结构展示和管理 - 标签管理: 颜色标签和统计信息 - 用户管理: 角色权限控制 - 系统设置: 多标签配置界面 - 添加pre-commit代码质量检查 🔧 部署配置: - Docker Compose完整配置 - 后端CI/CD流水线 (Docker部署) - 管理后台CI/CD流水线 (静态文件部署) - 前端CI/CD流水线优化 - 自动化脚本: 部署、备份、监控 - 完整的部署文档和运维指南 ✅ 集成完成: - 所有API接口正常连接 - 认证系统完整集成 - 数据获取和状态管理 - 错误处理和用户反馈 - 响应式设计优化
261 lines
8.4 KiB
YAML
261 lines
8.4 KiB
YAML
name: 部署后端服务
|
|
|
|
on:
|
|
push:
|
|
branches: [ main ]
|
|
paths:
|
|
- 'backend/**'
|
|
- 'docker-compose.yml'
|
|
- '.env.example'
|
|
- '.gitea/workflows/deploy-backend.yml'
|
|
workflow_dispatch:
|
|
|
|
env:
|
|
REGISTRY: registry.cn-hangzhou.aliyuncs.com
|
|
IMAGE_NAME: photography/backend
|
|
|
|
jobs:
|
|
test:
|
|
name: 🧪 测试后端
|
|
runs-on: ubuntu-latest
|
|
|
|
services:
|
|
postgres:
|
|
image: postgres:15-alpine
|
|
env:
|
|
POSTGRES_PASSWORD: postgres
|
|
POSTGRES_DB: photography_test
|
|
options: >-
|
|
--health-cmd pg_isready
|
|
--health-interval 10s
|
|
--health-timeout 5s
|
|
--health-retries 5
|
|
ports:
|
|
- 5432:5432
|
|
|
|
steps:
|
|
- name: 📥 检出代码
|
|
uses: actions/checkout@v4
|
|
|
|
- name: 🐹 设置 Go 环境
|
|
uses: actions/setup-go@v4
|
|
with:
|
|
go-version: '1.21'
|
|
cache-dependency-path: backend/go.sum
|
|
|
|
- name: 📦 下载依赖
|
|
working-directory: ./backend
|
|
run: go mod download
|
|
|
|
- name: 🔍 代码检查
|
|
working-directory: ./backend
|
|
run: |
|
|
go vet ./...
|
|
go fmt ./...
|
|
# 检查是否有格式化变更
|
|
if [ -n "$(git status --porcelain)" ]; then
|
|
echo "代码格式不符合规范,请运行 go fmt"
|
|
exit 1
|
|
fi
|
|
|
|
- name: 🧪 运行测试
|
|
working-directory: ./backend
|
|
env:
|
|
DB_HOST: localhost
|
|
DB_PORT: 5432
|
|
DB_USER: postgres
|
|
DB_PASSWORD: postgres
|
|
DB_NAME: photography_test
|
|
JWT_SECRET: test_jwt_secret_for_ci_cd_testing_only
|
|
run: |
|
|
go test -v -race -coverprofile=coverage.out ./...
|
|
go tool cover -html=coverage.out -o coverage.html
|
|
|
|
- name: 📊 上传覆盖率报告
|
|
uses: actions/upload-artifact@v3
|
|
with:
|
|
name: coverage-report
|
|
path: backend/coverage.html
|
|
|
|
- name: 🏗️ 构建检查
|
|
working-directory: ./backend
|
|
run: |
|
|
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main cmd/server/main.go
|
|
echo "构建成功"
|
|
|
|
build-and-deploy:
|
|
name: 🚀 构建并部署
|
|
runs-on: ubuntu-latest
|
|
needs: test
|
|
if: github.ref == 'refs/heads/main'
|
|
|
|
steps:
|
|
- name: 📥 检出代码
|
|
uses: actions/checkout@v4
|
|
|
|
- name: 🐳 设置 Docker Buildx
|
|
uses: docker/setup-buildx-action@v3
|
|
|
|
- name: 🔑 登录到镜像仓库
|
|
uses: docker/login-action@v3
|
|
with:
|
|
registry: ${{ env.REGISTRY }}
|
|
username: ${{ secrets.DOCKER_USERNAME }}
|
|
password: ${{ secrets.DOCKER_PASSWORD }}
|
|
|
|
- name: 📝 提取元数据
|
|
id: meta
|
|
uses: docker/metadata-action@v5
|
|
with:
|
|
images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
|
|
tags: |
|
|
type=ref,event=branch
|
|
type=ref,event=pr
|
|
type=sha,prefix={{branch}}-
|
|
type=raw,value=latest,enable={{is_default_branch}}
|
|
|
|
- name: 🏗️ 构建并推送镜像
|
|
uses: docker/build-push-action@v5
|
|
with:
|
|
context: ./backend
|
|
file: ./backend/Dockerfile
|
|
platforms: linux/amd64
|
|
push: true
|
|
tags: ${{ steps.meta.outputs.tags }}
|
|
labels: ${{ steps.meta.outputs.labels }}
|
|
cache-from: type=gha
|
|
cache-to: type=gha,mode=max
|
|
|
|
- name: 🚀 部署到生产环境
|
|
uses: appleboy/ssh-action@v1.0.0
|
|
with:
|
|
host: ${{ secrets.HOST }}
|
|
username: ${{ secrets.USERNAME }}
|
|
key: ${{ secrets.SSH_KEY }}
|
|
port: ${{ secrets.PORT }}
|
|
script: |
|
|
# 切换到项目目录
|
|
cd /home/gitea/photography
|
|
|
|
# 拉取最新代码
|
|
git pull origin main
|
|
|
|
# 备份当前运行的容器 (如果存在)
|
|
if docker ps -q -f name=photography_backend; then
|
|
echo "📦 备份当前后端容器..."
|
|
docker commit photography_backend photography_backend_backup_$(date +%Y%m%d_%H%M%S)
|
|
fi
|
|
|
|
# 停止现有服务
|
|
echo "🛑 停止现有服务..."
|
|
docker-compose down backend || true
|
|
|
|
# 拉取最新镜像
|
|
echo "📥 拉取最新镜像..."
|
|
docker-compose pull backend
|
|
|
|
# 启动数据库 (如果未运行)
|
|
echo "🗄️ 确保数据库运行..."
|
|
docker-compose up -d postgres redis
|
|
|
|
# 等待数据库就绪
|
|
echo "⏳ 等待数据库就绪..."
|
|
sleep 10
|
|
|
|
# 运行数据库迁移
|
|
echo "🔄 运行数据库迁移..."
|
|
docker-compose run --rm backend ./main migrate || echo "迁移完成或已是最新"
|
|
|
|
# 启动后端服务
|
|
echo "🚀 启动后端服务..."
|
|
docker-compose up -d backend
|
|
|
|
# 等待服务启动
|
|
echo "⏳ 等待服务启动..."
|
|
sleep 30
|
|
|
|
# 健康检查
|
|
echo "🔍 执行健康检查..."
|
|
for i in {1..30}; do
|
|
if curl -f http://localhost:8080/health > /dev/null 2>&1; then
|
|
echo "✅ 后端服务健康检查通过"
|
|
break
|
|
fi
|
|
echo "等待后端服务启动... ($i/30)"
|
|
sleep 10
|
|
done
|
|
|
|
# 检查服务状态
|
|
echo "📊 检查服务状态..."
|
|
docker-compose ps
|
|
|
|
# 清理旧镜像 (保留最近3个)
|
|
echo "🧹 清理旧镜像..."
|
|
docker images ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }} --format "table {{.Repository}}:{{.Tag}}\t{{.CreatedAt}}" | tail -n +2 | sort -k2 -r | tail -n +4 | awk '{print $1}' | xargs -r docker rmi || true
|
|
|
|
# 清理旧备份容器 (保留最近5个)
|
|
docker images photography_backend_backup_* --format "table {{.Repository}}:{{.Tag}}\t{{.CreatedAt}}" | tail -n +2 | sort -k2 -r | tail -n +6 | awk '{print $1}' | xargs -r docker rmi || true
|
|
|
|
echo "🎉 后端部署完成!"
|
|
|
|
- name: 📧 发送部署通知
|
|
if: always()
|
|
uses: appleboy/telegram-action@master
|
|
with:
|
|
to: ${{ secrets.TELEGRAM_TO }}
|
|
token: ${{ secrets.TELEGRAM_TOKEN }}
|
|
message: |
|
|
🔧 摄影作品集后端部署
|
|
|
|
📦 项目: ${{ github.repository }}
|
|
🌿 分支: ${{ github.ref_name }}
|
|
👤 提交者: ${{ github.actor }}
|
|
📝 提交信息: ${{ github.event.head_commit.message }}
|
|
|
|
${{ job.status == 'success' && '✅ 部署成功' || '❌ 部署失败' }}
|
|
|
|
🌐 API: https://api.photography.iriver.top/health
|
|
📊 监控: https://admin.photography.iriver.top
|
|
|
|
rollback:
|
|
name: 🔄 回滚部署
|
|
runs-on: ubuntu-latest
|
|
if: failure() && github.ref == 'refs/heads/main'
|
|
needs: build-and-deploy
|
|
|
|
steps:
|
|
- name: 🔄 执行回滚
|
|
uses: appleboy/ssh-action@v1.0.0
|
|
with:
|
|
host: ${{ secrets.HOST }}
|
|
username: ${{ secrets.USERNAME }}
|
|
key: ${{ secrets.SSH_KEY }}
|
|
port: ${{ secrets.PORT }}
|
|
script: |
|
|
cd /home/gitea/photography
|
|
|
|
echo "🔄 开始回滚后端服务..."
|
|
|
|
# 查找最新的备份容器
|
|
BACKUP_IMAGE=$(docker images photography_backend_backup_* --format "table {{.Repository}}:{{.Tag}}\t{{.CreatedAt}}" | tail -n +2 | sort -k2 -r | head -n 1 | awk '{print $1}')
|
|
|
|
if [ -n "$BACKUP_IMAGE" ]; then
|
|
echo "📦 找到备份镜像: $BACKUP_IMAGE"
|
|
|
|
# 停止当前服务
|
|
docker-compose down backend
|
|
|
|
# 标记备份镜像为最新
|
|
docker tag $BACKUP_IMAGE photography_backend:rollback
|
|
|
|
# 修改 docker-compose 使用回滚镜像
|
|
sed -i 's|build: .*|image: photography_backend:rollback|g' docker-compose.yml
|
|
|
|
# 启动回滚版本
|
|
docker-compose up -d backend
|
|
|
|
echo "✅ 回滚完成"
|
|
else
|
|
echo "❌ 未找到备份镜像,无法回滚"
|
|
exit 1
|
|
fi |