90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
---
|
||
name: dukang-release
|
||
description: >-
|
||
杜康好客生产发布流程：dev_jacy 提交合并到 dev，并用 deploy.sh 发版。
|
||
Use when the user says 发布、上传、deploy、上线、发版, or @杜康发布 / @dukang-release.
|
||
---
|
||
|
||
# 杜康发布
|
||
|
||
将已完成改动发到生产（`aliyun-smarthr`）。**仅用户明确要求发布时执行。**
|
||
|
||
## 分支约定
|
||
|
||
| 分支 | 用途 |
|
||
|------|------|
|
||
| `dev_jacy` | 日常开发 / 提交 |
|
||
| `dev` | **发布分支**（服务器拉这个） |
|
||
|
||
默认：`dev_jacy` → merge → `dev` → 部署。勿 force push `main`/`dev`。
|
||
|
||
## 标准流程（Windows）
|
||
|
||
PowerShell 下 **分支名必须加引号**（否则 `checkout` 与 `dev` 会被粘成 `checkoutdev`）。
|
||
|
||
### 1. 提交（在 `dev_jacy`）
|
||
|
||
```powershell
|
||
git status -sb
|
||
git add <files>
|
||
git commit -m @"
|
||
fix(scope): summary
|
||
|
||
Optional body.
|
||
"@
|
||
```
|
||
|
||
- Conventional Commits；不提交 `.env` / `dist` / `node_modules`
|
||
- 用户未要求 commit 时不要擅自提交
|
||
|
||
### 2. 推送并合并到 `dev`
|
||
|
||
```powershell
|
||
git push -u origin HEAD
|
||
git checkout "dev"
|
||
git pull origin "dev"
|
||
git merge "dev_jacy" -m "merge(dev_jacy): <简述>"
|
||
git push origin "dev"
|
||
git checkout "dev_jacy"
|
||
```
|
||
|
||
### 3. 远程发版
|
||
|
||
本机无 WSL bash 时用 **Git Bash**：
|
||
|
||
```powershell
|
||
& "C:\Program Files\Git\bin\bash.exe" "<repo>/deploy/deploy.sh" --branch "dev" -- --skip-db
|
||
```
|
||
|
||
- 默认加 `--skip-db`（无迁移时）
|
||
- 有 Prisma 迁移时去掉 `--skip-db`，按用户确认是否 `--seed` / `--accept-data-loss`
|
||
- `deploy/deploy.env` 提供 `DEPLOY_HOST` 等（勿提交密钥）
|
||
|
||
### 4. 等待完成
|
||
|
||
后台跑部署时轮询终端输出，成功标志：
|
||
|
||
- 出现 `发版完成`
|
||
- `exit_code: 0`
|
||
- `mini-user(h5): 200`（或对应前端 200）
|
||
|
||
说明：API 健康检查短暂 `FAIL`/`000` 多为重启中，以 `发版完成` + `exit_code: 0` 为准。
|
||
|
||
### 5. 回复用户
|
||
|
||
一句说明：已合并 commit、发版结果、建议微信强刷验证。
|
||
|
||
## 常用变体
|
||
|
||
| 场景 | 做法 |
|
||
|------|------|
|
||
| 仅部署已推送的 `dev` | 跳过 commit/merge，直接跑 `deploy.sh --branch "dev" -- --skip-db` |
|
||
| 检查服务器 | `deploy.sh --branch "dev" --check` |
|
||
| 含 DB | `deploy.sh --branch "dev" --`（无 skip-db）或按用户给 seed 参数 |
|
||
|
||
## 禁止
|
||
|
||
- 不 amend 已推送 commit；不 force push `main`/`master`/`dev`
|
||
- 不把 `.env` / 私钥打进仓库
|
||
- 用户只说「修好」未说发布时 → **只改代码，不发版**
|