102 lines
1.7 KiB
Markdown
102 lines
1.7 KiB
Markdown
|
# 部署文档
|
|||
|
|
|
|||
|
|
## 版本信息
|
|||
|
|
|
|||
|
|
- 版本: v1.0.0
|
|||
|
|
- 最后更新: 2025-01-XX
|
|||
|
|
- 维护者: 运维团队
|
|||
|
|
|
|||
|
|
## 部署前准备
|
|||
|
|
|
|||
|
|
### 1. 环境要求
|
|||
|
|
|
|||
|
|
- Python 3.8+
|
|||
|
|
- 数据库（MySQL/PostgreSQL/SQLite）
|
|||
|
|
- 反向代理（Nginx，可选）
|
|||
|
|
|
|||
|
|
### 2. 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装生产依赖
|
|||
|
|
pip install -r requirements/base.txt
|
|||
|
|
pip install -r requirements/production.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 配置环境变量
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 设置生产环境
|
|||
|
|
export FLASK_ENV=production
|
|||
|
|
|
|||
|
|
# 配置必要的环境变量
|
|||
|
|
# - SECRET_KEY
|
|||
|
|
# - DATABASE_URL
|
|||
|
|
# - CORS_ORIGINS
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 部署方式
|
|||
|
|
|
|||
|
|
### 方式1: 使用Gunicorn
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 使用配置文件
|
|||
|
|
gunicorn -c gunicorn.conf.py "src.your_app:create_app()"
|
|||
|
|
|
|||
|
|
# 或直接指定参数
|
|||
|
|
gunicorn --bind 0.0.0.0:5000 --workers 4 "src.your_app:create_app()"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方式2: 使用uWSGI
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
uwsgi --ini uwsgi.ini
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方式3: 使用Docker
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 构建镜像
|
|||
|
|
docker build -t your_app .
|
|||
|
|
|
|||
|
|
# 运行容器
|
|||
|
|
docker run -d -p 5000:5000 --env-file .env your_app
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Nginx配置示例
|
|||
|
|
|
|||
|
|
```nginx
|
|||
|
|
server {
|
|||
|
|
listen 80;
|
|||
|
|
server_name your_domain.com;
|
|||
|
|
|
|||
|
|
location / {
|
|||
|
|
proxy_pass http://127.0.0.1:5000;
|
|||
|
|
proxy_set_header Host $host;
|
|||
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|||
|
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|||
|
|
proxy_set_header X-Forwarded-Proto $scheme;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 监控和日志
|
|||
|
|
|
|||
|
|
### 日志位置
|
|||
|
|
|
|||
|
|
- 应用日志: `logs/app.log`
|
|||
|
|
- Gunicorn访问日志: `logs/gunicorn_access.log`
|
|||
|
|
- Gunicorn错误日志: `logs/gunicorn_error.log`
|
|||
|
|
|
|||
|
|
### 监控建议
|
|||
|
|
|
|||
|
|
- 使用Supervisor管理进程
|
|||
|
|
- 配置日志轮转
|
|||
|
|
- 设置健康检查端点
|
|||
|
|
|
|||
|
|
## 变更记录
|
|||
|
|
|
|||
|
|
### v1.0.0 (2025-01-XX)
|
|||
|
|
- 初始版本
|
|||
|
|
- 添加部署文档
|
|||
|
|
|