feat: 完成后端-管理后台集成及部署配置
🚀 主要功能: - 完善后端API服务层,实现完整的CRUD操作 - 开发管理后台所有核心页面 (仪表板、照片、分类、标签、用户、设置) - 完成前后端完全集成,所有API接口正常对接 - 配置完整的CI/CD流水线,支持自动化部署 🎯 后端完善: - 实现PhotoService, CategoryService, TagService, UserService - 添加完整的API处理器和路由配置 - 支持Docker容器化部署 - 添加数据库迁移和健康检查 🎨 管理后台完成: - 仪表板: 实时统计数据展示 - 照片管理: 完整的CRUD操作,支持批量处理 - 分类管理: 树形结构展示和管理 - 标签管理: 颜色标签和统计信息 - 用户管理: 角色权限控制 - 系统设置: 多标签配置界面 - 添加pre-commit代码质量检查 🔧 部署配置: - Docker Compose完整配置 - 后端CI/CD流水线 (Docker部署) - 管理后台CI/CD流水线 (静态文件部署) - 前端CI/CD流水线优化 - 自动化脚本: 部署、备份、监控 - 完整的部署文档和运维指南 ✅ 集成完成: - 所有API接口正常连接 - 认证系统完整集成 - 数据获取和状态管理 - 错误处理和用户反馈 - 响应式设计优化
This commit is contained in:
261
.gitea/workflows/deploy-backend.yml
Normal file
261
.gitea/workflows/deploy-backend.yml
Normal file
@ -0,0 +1,261 @@
|
||||
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
|
||||
Reference in New Issue
Block a user