name: 构建并部署前端 on: push: tags: ['v*'] workflow_dispatch: concurrency: group: deploy-frontend cancel-in-progress: false env: # 生产机 nginx root 目录(静态资源部署目标) DEPLOY_DIR: /www/zt-closet-manage.lzcwy.cn # 蓝绿切换用的临时目录(位于 nginx root 之外,不会被对外访问) STAGING_DIR: /www/.zt-closet-deploy-tmp jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: 拉取代码 uses: https://gitee.com/liu_zhengchi/checkout@v4 - name: 设置 Node.js uses: actions/setup-node@v4 with: # 匹配 package.json engines: ^22.18.0 || >=24.12.0 node-version: '22' cache: 'npm' - name: 安装依赖 run: npm ci - name: 类型检查并构建 run: npm run build - name: 确认构建产物 run: | if [ ! -f dist/index.html ]; then echo "构建产物 dist/index.html 不存在,构建可能失败" >&2 exit 1 fi echo "构建产物:" ls -la dist - name: SSH 部署到生产机(蓝绿原子切换) env: SSH_KEY: ${{ secrets.ZT_CLOSET_PROD_SSH_KEY }} SSH_HOST: ${{ vars.ZT_CLOSET_PROD_SSH_HOST }} SSH_USER: ${{ vars.ZT_CLOSET_PROD_SSH_USER }} run: | # runner 默认未安装 rsync,先装上(生产机一般自带,无需处理) if ! command -v rsync >/dev/null 2>&1; then sudo apt-get update -y && sudo apt-get install -y rsync fi mkdir -p ~/.ssh && chmod 700 ~/.ssh printf '%s\n' "$SSH_KEY" > ~/.ssh/deploy_key chmod 600 ~/.ssh/deploy_key SSHOPT="-i ~/.ssh/deploy_key -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null" # 1) 先把产物 rsync 到远端临时目录(--delete 清理上一版遗留的旧 hash 资源), # 此步骤绝不触碰线上目录,rsync 中断也不会影响线上。 rsync -az --delete -e "ssh $SSHOPT" dist/ "$SSH_USER@$SSH_HOST:$STAGING_DIR/" # 2) 远端校验临时目录 + 蓝绿原子切换(mv) ssh $SSHOPT "$SSH_USER@$SSH_HOST" 'bash -s' <<'REMOTE' set -e DIR="/www/zt-closet-manage.lzcwy.cn" TMP="/www/.zt-closet-deploy-tmp" BACKUP="/www/.zt-closet-backup-$(date +%Y%m%d%H%M%S)" # 校验临时目录产物完整(否则中止,线上版本不受任何影响) if [ ! -f "$TMP/index.html" ]; then echo "临时目录缺少 index.html,部署中止,线上版本保持不变" >&2 exit 1 fi # 首次部署时线上目录可能不存在,做兼容 if [ -d "$DIR" ]; then mv "$DIR" "$BACKUP" fi mv "$TMP" "$DIR" # 切换后校验,失败则秒级回滚(把备份 mv 回去) if [ ! -f "$DIR/index.html" ]; then echo "切换后校验失败,执行回滚" >&2 rm -rf "$DIR" if [ -d "$BACKUP" ]; then mv "$BACKUP" "$DIR" fi exit 1 fi # 成功:仅保留最近一次备份,清理更早的 ls -1dt /www/.zt-closet-backup-* 2>/dev/null | tail -n +2 | xargs -r rm -rf echo "部署成功:$DIR" REMOTE - name: 部署结果 if: always() run: echo "前端部署流程结束(目标 ${{ env.DEPLOY_DIR }})" - name: 通知钉钉 if: always() env: DINGTALK_TOKEN: ${{ secrets.ZT_CLOSET_DINGTALK_TOKEN }} JOB_RESULT: ${{ jobs.build-and-deploy.result }} run: | if [ "$JOB_RESULT" = "success" ]; then STATUS="✅ 前端部署成功" COLOR="info" else STATUS="❌ 前端部署失败" COLOR="warning" fi curl -s -X POST "https://oapi.dingtalk.com/robot/send?access_token=${DINGTALK_TOKEN}" \ -H 'Content-Type: application/json' \ -d "{ \"msgtype\": \"markdown\", \"markdown\": { \"title\": \"前端部署通知\", \"text\": \"## 前端部署通知\n\n**结果**:${STATUS}\n\n**触发人**:${{ gitea.actor }}\n**分支/标签**:${{ gitea.ref_name }}\n**提交**:[${{ gitea.sha }}](${{ gitea.server_url }}/${{ gitea.repository }}/commit/${{ gitea.sha }})\n**流水线**:[${{ gitea.run_id }}](${{ gitea.server_url }}/${{ gitea.repository }}/actions/runs/${{ gitea.run_id }})\n" } }" echo "钉钉通知已发送:${STATUS}"