HeyGem.ai CI/CD自动化部署指南：5分钟搭建完整AI项目发布流程

HeyGem.ai CI/CD自动化部署指南：5分钟搭建完整AI项目发布流程

【免费下载链接】HeyGem.ai 项目地址: https://gitcode.com/GitHub_Trending/he/HeyGem.ai

HeyGem.ai是一个开源的AI数字人项目，提供完整的CI/CD自动化部署解决方案。本文将详细介绍如何为HeyGem.ai项目配置自动化部署流程，让您的AI应用发布变得简单高效。

📦 项目结构与部署配置

HeyGem.ai项目提供多种Docker Compose部署方案，位于deploy/目录下：

• docker-compose.yml - 完整部署方案（包含TTS、ASR、视频生成）
• docker-compose-linux.yml - Linux环境优化版本
• docker-compose-lite.yml - 精简版部署
• docker-compose-5090.yml - 特定GPU版本配置

🚀 快速启动部署流程

环境要求

• Docker & Docker Compose
• NVIDIA GPU（推荐）
• 至少16GB内存

一键部署命令

# 克隆项目
git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai
cd HeyGem.ai

# 使用完整部署方案
docker-compose -f deploy/docker-compose.yml up -d

服务端口说明

• TTS服务: 18180
• ASR服务: 10095
• 视频生成服务: 8383

🔧 构建配置详解

Electron应用构建

项目使用electron-builder进行跨平台打包，配置见electron-builder.yml：

appId: com.duix.avatar
productName: Duix.Avatar
directories:
  output: dist-electron
  buildResources: build

多平台构建脚本

package.json中定义了完整的构建命令：

"scripts": {
  "build:win": "npm run build && electron-builder --win",
  "build:linux": "npm run build && electron-builder --linux",
  "build:unpack": "npm run build && electron-builder --dir"
}

⚡ CI/CD自动化实践

GitHub Actions配置建议

创建.github/workflows/deploy.yml：

name: Deploy HeyGem.ai

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Build Electron App
      run: npm run build:linux
    - name: Deploy to Server
      uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.SERVER_HOST }}
        username: ${{ secrets.SERVER_USER }}
        key: ${{ secrets.SERVER_SSH_KEY }}
        script: |
          cd /opt/heygem-ai
          docker-compose down
          docker-compose up -d --build

🎯 部署优化技巧

1. 资源监控配置

在docker-compose中添加资源限制：

deploy:
  resources:
    reservations:
      devices:
        - driver: nvidia
          count: 1
          capabilities: [gpu]

2. 数据持久化

确保数据目录挂载正确：

volumes:
  - ~/heygem_data/face2face:/code/data

3. 健康检查

添加服务健康检查：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8383/health"]
  interval: 30s
  timeout: 10s
  retries: 3

💡 常见问题解决

GPU驱动问题

确保NVIDIA容器工具包已安装：

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit

内存不足处理

调整Docker内存分配：

sudo systemctl edit docker
# 添加：--default-shm-size="8g"

📊 部署验证

部署完成后，访问以下端点验证服务状态：

• http://localhost:18180/health - TTS服务健康检查
• http://localhost:8383/status - 视频生成服务状态
• http://localhost:10095/ - ASR服务状态

🎉 总结

HeyGem.ai提供了完整的CI/CD部署解决方案，通过Docker Compose实现一键部署，结合GitHub Actions可实现全自动化发布流程。本文介绍的部署方法既适合本地开发环境，也适用于生产环境部署。

记得定期更新Docker镜像以获取最新功能和安全补丁：

docker-compose pull
docker-compose up -d

享受您的高效AI应用部署体验！🚀

【免费下载链接】HeyGem.ai 项目地址: https://gitcode.com/GitHub_Trending/he/HeyGem.ai