diff --git a/.gitea-ci.yml b/.gitea-ci.yml new file mode 100644 index 0000000..317d752 --- /dev/null +++ b/.gitea-ci.yml @@ -0,0 +1,98 @@ +stages: + - build + - deploy + +variables: + NODE_VERSION: "18" + +cache: + key: ${CI_COMMIT_REF_SLUG} + paths: + - node_modules/ + +before_script: + - npm config set registry https://registry.npmmirror.com + +build-dev: + stage: build + only: + - develop + tags: + - docker + image: node:18-alpine + script: + - npm ci + - npm run type-check || true + - npm run lint || true + - npm run build + artifacts: + name: "dev-$CI_COMMIT_REF_NAME-$CI_COMMIT_SHA" + paths: + - dist/ + expire_in: 1 day + +deploy-dev: + stage: deploy + only: + - develop + tags: + - docker + image: alpine:latest + before_script: + - apk add --no-cache openssh-client rsync + script: + - eval $(ssh-agent -s) + - mkdir -p ~/.ssh && chmod 700 ~/.ssh + - ssh-keyscan -H $DEV_SERVER_IP >> ~/.ssh/known_hosts 2>/dev/null + - echo "$DEV_SSH_PASSWORD" | sshpass ssh -o StrictHostKeyChecking=no + root@$DEV_SERVER_IP "mkdir -p $DEV_SERVER_PATH && chmod 755 + $DEV_SERVER_PATH" + - sshpass -p "$DEV_SSH_PASSWORD" rsync -avz --delete -e "ssh -o + StrictHostKeyChecking=no" dist/ root@$DEV_SERVER_IP:$DEV_SERVER_PATH + needs: + - job: build-dev + artifacts: true + when: manual + +build-prod: + stage: build + only: + - master + - main + tags: + - docker + image: node:18-alpine + script: + - npm ci + - npm run type-check || true + - npm run lint || true + - npm run build + artifacts: + name: "prod-$CI_COMMIT_REF_NAME-$CI_COMMIT_SHA" + paths: + - dist/ + expire_in: 7 days + +deploy-prod: + stage: deploy + only: + - master + - main + tags: + - docker + image: alpine:latest + before_script: + - apk add --no-cache openssh-client rsync sshpass + script: + - eval $(ssh-agent -s) + - mkdir -p ~/.ssh && chmod 700 ~/.ssh + - ssh-keyscan -H $PROD_SERVER_IP >> ~/.ssh/known_hosts 2>/dev/null + - echo "$PROD_SSH_PASSWORD" | sshpass ssh -o StrictHostKeyChecking=no + root@$PROD_SERVER_IP "mkdir -p $PROD_SERVER_PATH && chmod 755 + $PROD_SERVER_PATH" + - sshpass -p "$PROD_SSH_PASSWORD" rsync -avz --delete -e "ssh -o + StrictHostKeyChecking=no" dist/ root@$PROD_SERVER_IP:$PROD_SERVER_PATH + needs: + - job: build-prod + artifacts: true + when: manual diff --git a/CICD_SETUP.md b/CICD_SETUP.md new file mode 100644 index 0000000..1b50579 --- /dev/null +++ b/CICD_SETUP.md @@ -0,0 +1,149 @@ +# 宝塔面板 + Gitea CI/CD 配置指南 + +## 整体流程 + +``` +代码推送 → Gitea CI/CD自动构建 → SSH上传到宝塔服务器 → 完成! +``` + +## 宝塔面板准备工作 + +### 1. 确认SSH权限 + +在宝塔面板中确认: +- **面板设置 → 面板账户** 中的SSH信息 +- 或者在**安全 → SSH管理**中查看 + +### 2. 确保目录存在 + +在宝塔终端或SSH中创建部署目录: + +```bash +# 开发服务器 +mkdir -p /www/wwwroot/test1.stnav.com/public/parten +chmod -R 755 /www/wwwroot/test1.stnav.com/public/parten + +# 生产服务器 +mkdir -p /www/wwwroot/default/chaz_admin/public/parten +chmod -R 755 /www/wwwroot/default/chaz_admin/public/parten +``` + +## Gitea Secrets配置 + +在仓库 **Settings → Secrets** 中添加以下变量: + +### 开发服务器 + +| 变量名 | 值示例 | 说明 | +|--------|--------|------| +| `DEV_SERVER_IP` | `192.168.1.100` | 开发服务器IP | +| `DEV_SERVER_PATH` | `/www/wwwroot/test1.stnav.com/public/parten` | 部署路径 | +| `DEV_SSH_PASSWORD` | `你的SSH密码` | 服务器SSH密码 | + +### 生产服务器 + +| 变量名 | 值示例 | 说明 | +|--------|--------|------| +| `PROD_SERVER_IP` | `192.168.1.101` | 生产服务器IP | +| `PROD_SERVER_PATH` | `/www/wwwroot/default/chaz_admin/public/parten` | 部署路径 | +| `PROD_SSH_PASSWORD` | `你的SSH密码` | 服务器SSH密码 | + +## 宝塔防火墙配置 + +确保服务器的SSH端口(默认22)对Gitea Runner开放: + +1. 宝塔面板 → 安全 → 防火墙 +2. 放行22端口(或你自定义的SSH端口) + +## 使用流程 + +### 开发环境(develop分支) + +1. **推送代码** + ```bash + git checkout develop + git add . + git commit -m "update" + git push origin develop + ``` + +2. **自动构建** - Gitea自动触发 `build-dev` + +3. **手动部署** + - 进入仓库 **CI/CD → Pipelines** + - 找到 develop 分支的 Pipeline + - 点击 `deploy-dev` 的播放按钮 ▶️ + +4. **验证** - 访问 `https://test1.stnav.com/parten` + +### 生产环境(master分支) + +1. **合并代码** + ```bash + git checkout master + git merge develop + git push origin master + ``` + +2. **自动构建** - Gitea自动触发 `build-prod` + +3. **手动部署** + - 进入仓库 **CI/CD → Pipelines** + - 找到 master 分支的 Pipeline + - 点击 `deploy-prod` 的播放按钮 ▶️ + +4. **验证** - 访问生产环境地址 + +## 宝塔站点配置(可选) + +如果需要配置域名访问: + +1. 宝塔面板 → 网站 → 添加站点 +2. 填写域名(如:`test1.stnav.com`) +3. 根目录选择 `/www/wwwroot/test1.stnav.com/public` +4. 创建完成后,在站点设置中: + - 网站目录 → 运行目录改为 `parten` + - 或创建反向代理到 `http://127.0.0.1:端口/parten` + +## 常见问题 + +### 1. SSH连接失败 +``` +检查: +- 服务器IP是否正确 +- SSH密码是否正确 +- 防火墙是否放行22端口 +- 宝塔SSH是否开启 +``` + +### 2. 权限被拒绝 +``` +解决: +- 确认目标目录存在 +- 检查目录权限:chmod 755 目录路径 +- 确认SSH用户有写入权限 +``` + +### 3. 构建成功但部署失败 +``` +检查: +- Secrets中的密码是否正确 +- 部署路径是否正确 +- 服务器SSH服务是否运行 +``` + +## 安全建议 + +⚠️ **重要提醒:** +- 生产服务器的密码建议定期更换 +- 考虑使用Gitea的受限Runner来提高安全性 +- 监控CI/CD日志,及时发现异常 + +## 优势 + +使用宝塔面板的优势: +- ✅ 可视化管理服务器 +- ✅ 方便查看日志和文件 +- ✅ 内置防火墙和安全防护 +- ✅ 简化SSL证书配置 +- ✅ 图形化Nginx/Apache配置