生产部署快速开始

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# 生产环境部署快速指南

这是一份**简单实用**的生产环境部署指南，帮你快速安全地部署到生产环境。

---

## &#128640; 一键部署（推荐）

```bash
# 拉取代码
git pull origin main

# 构建并部署
pnpm deploy:prod

# 查看日志
pm2 logs payroll --lines 50
```

---

## &#128203; 核心三步

### 1. 检查代码

```bash
# 检查代码质量
pnpm lint
pnpm type-check
pnpm format:check
```

### 2. 构建项目

```bash
# 运行构建脚本
bash scripts/build-prod.sh
```

这个脚本会自动：
- ✅ 清理缓存
- ✅ ESLint 检查
- ✅ TypeScript 类型检查
- ✅ Prettier 格式化检查
- ✅ 构建生产版本
- ✅ 验证构建产物

### 3. 重启服务

```bash
# 重启 PM2 服务
pm2 restart payroll

# 查看日志
pm2 logs payroll --lines 50
```

---

## ✅ 验证部署

### 服务检查

```bash
# 检查服务状态
pm2 status

# 检查端口
netstat -tlnp | grep 5000

# 检查健康
curl http://localhost:5000/api/health
```

### 功能检查

```bash
# 访问首页
curl http://localhost:5000

# 测试登录（需要根据实际情况修改）
curl -X POST http://localhost:5000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your-password"}'
```

---

## &#128260; 快速回滚

```bash
# 使用回滚脚本
bash scripts/rollback-prod.sh

# 或手动回滚
git reset --hard HEAD~1
bash scripts/build-prod.sh
pm2 restart payroll
```

---

## &#128202; 常用命令

### 部署相关

```bash
# 快速部署
pnpm deploy:prod

# 快速回滚
pnpm rollback:prod

# 查看服务状态
pm2 status

# 查看日志
pm2 logs payroll
```

### 检查相关

```bash
# 代码检查
pnpm lint
pnpm type-check
pnpm format:check

# 综合检查
pnpm quality:check
```

---

## &#128221; 部署前检查清单

### 必须检查

- [ ] `pnpm lint` 通过
- [ ] `pnpm type-check` 通过
- [ ] `pnpm format:check` 通过
- [ ] `.env.production` 已配置
- [ ] `DATABASE_URL` 正确
- [ ] `JWT_SECRET` 已设置

### 推荐检查

- [ ] 数据库已备份
- [ ] 当前版本已标记

---

## &#127384; 常见问题

### Q: 构建失败怎么办？

```bash
# 检查代码
pnpm lint
pnpm type-check
pnpm format:check

# 修复后重新构建
bash scripts/build-prod.sh
```

### Q: 服务启动失败怎么办？

```bash
# 查看日志
pm2 logs payroll --lines 100

# 检查配置
cat .env.production

# 重启服务
pm2 restart payroll
```

### Q: 如何快速回滚？

```bash
# 一键回滚
bash scripts/rollback-prod.sh

# 或手动回滚
git reset --hard HEAD~1
bash scripts/build-prod.sh
pm2 restart payroll
```

---

## &#128218; 完整文档

- [生产环境部署规范](./生产部署标准.md) - 完整的部署规范
- [生产环境部署检查清单](./生产部署检查清单.md) - 详细的检查清单（可打印）
- [服务器部署步骤](./部署指南.md) - 服务器环境配置
- [Docker 部署指南](./Docker部署.md) - Docker 部署方式

---

## &#128161; 提示

1. **部署前先备份**：避免数据丢失
2. **小步快跑**：频繁部署，减少风险
3. **及时验证**：部署后立即检查
4. **保留回滚方案**：出问题立即回滚
5. **记录日志**：每次部署都要记录

---

## &#127919; 最简流程

```bash
# 1. 拉取代码
git pull origin main

# 2. 构建部署
pnpm deploy:prod

# 3. 验证
pm2 status
curl http://localhost:5000/api/health
```

---

**记住：宁可多检查一遍，也不要半夜起来修 BUG。** &#128640;