cloud-mcp/QUICK_START.md

快速部署指南

服务器端设置（一次性）

1. 克隆项目

git clone <your-gitea-repo-url> /opt/cloud-mcp
cd /opt/cloud-mcp

2. 配置环境变量

cp env.template .env
nano .env  # 编辑配置

3. 设置脚本权限

chmod +x deploy.sh deploy-gitea.sh

4. 首次部署

./deploy.sh --rebuild

Gitea Webhook 自动部署设置

方法一：使用 Git Hook（推荐）

# 在服务器上设置 post-receive hook
cd /opt/cloud-mcp
git config receive.denyCurrentBranch ignore

# 创建 hook 脚本
cat > .git/hooks/post-receive << 'EOF'
#!/bin/bash
cd /opt/cloud-mcp
git checkout -f
./deploy-gitea.sh
EOF

chmod +x .git/hooks/post-receive

方法二：使用 Gitea Webhook

1. 在 Gitea 仓库设置中添加 Webhook
2. URL: http://your-server:port/hooks/deploy (需要 webhook 服务器)
3. 或使用 SSH 方式触发部署脚本

日常使用

手动部署

# 在服务器上
cd /opt/cloud-mcp
./deploy-gitea.sh

查看状态

./deploy-gitea.sh --status

查看日志

./deploy-gitea.sh --logs
# 或
docker logs -f cloud-mcp

使用 Makefile（可选）

make deploy    # 完整部署
make status    # 查看状态
make logs      # 查看日志
make restart   # 重启
make down      # 停止
make up        # 启动

更新流程

1. 本地开发 → 提交代码 → 推送到 Gitea
2. 自动触发 → Webhook/Hook 自动运行 deploy-gitea.sh
3. 完成 → 容器自动更新并重启

故障排查

# 检查容器状态
docker ps -a | grep cloud-mcp

# 查看详细日志
docker logs cloud-mcp

# 检查部署日志
tail -f deploy.log

# 手动重启
./deploy-gitea.sh --restart