docs: 添加测试环境部署指南
- 测试环境架构说明 - 详细部署步骤 - 常见问题及解决方案 - 短信配置说明
This commit is contained in:
甲辰生产
parent
f3625fa196
commit
4965bf68d3
|
|
@ -0,0 +1,186 @@
|
|||
# 测试环境部署指南
|
||||
|
||||
## 测试环境架构
|
||||
|
||||
| 服务器 | IP | 服务 |
|
||||
|--------|-----|------|
|
||||
| 测试机1 | 47.103.29.111 | 前端 (Nginx) |
|
||||
| 测试机2 | 47.103.9.192 | 后端 (FastAPI) + PostgreSQL |
|
||||
|
||||
## 部署步骤
|
||||
|
||||
### 1. 测试机1 - 前端部署
|
||||
|
||||
```bash
|
||||
# 拉取代码
|
||||
cd /root/jiachenlong
|
||||
git fetch --all
|
||||
git checkout v1.1.21
|
||||
|
||||
# 安装依赖并构建
|
||||
cd frontend
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# 复制静态文件到可访问目录
|
||||
mkdir -p /var/www/html
|
||||
cp -r dist/* /var/www/html/
|
||||
cp -r ../static /var/www/html/
|
||||
chmod -R 755 /var/www/html
|
||||
|
||||
# 配置Nginx
|
||||
cat > /etc/nginx/conf.d/jiachenlong-test.conf << 'EOF'
|
||||
server {
|
||||
listen 80;
|
||||
server_name _;
|
||||
|
||||
root /var/www/html;
|
||||
index index.html;
|
||||
|
||||
client_max_body_size 20M;
|
||||
|
||||
# 静态资源（logo、图片等）
|
||||
location /static {
|
||||
alias /var/www/html/static;
|
||||
expires 30d;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
|
||||
# SPA路由
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# API代理到后端
|
||||
location /api {
|
||||
proxy_pass http://47.103.9.192:3000/api;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
nginx -t && systemctl enable nginx && systemctl restart nginx
|
||||
```
|
||||
|
||||
### 2. 测试机2 - 后端部署
|
||||
|
||||
```bash
|
||||
# 拉取代码
|
||||
cd /root/jiachenlong
|
||||
git fetch --all
|
||||
git checkout v1.1.21
|
||||
|
||||
# 安装Python依赖
|
||||
pip3 install fastapi uvicorn sqlalchemy psycopg2-binary pydantic python-jose bcrypt python-multipart pillow dashscope alibabacloud-dysmsapi20170525 oss2 email-validator httpx python-dotenv
|
||||
|
||||
# 创建环境变量文件
|
||||
cat > backend/.env << 'EOF'
|
||||
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/zodiac
|
||||
SECRET_KEY=test-secret-key-for-sms
|
||||
ACCESS_TOKEN_EXPIRE_MINUTES=60
|
||||
OSS_ACCESS_KEY_ID=LTAI5t6HUnpFBLEK9194kPVG
|
||||
OSS_ACCESS_KEY_SECRET=LEr4Q8yRxb8D5b24cKfCwlt4MMoke1
|
||||
OSS_BUCKET=jiachenlong-oss
|
||||
OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
|
||||
SMS_ACCESS_KEY_ID=LTAI5tQAx5niD7JQVqGE5acE
|
||||
SMS_ACCESS_KEY_SECRET=QsQFAEKBkaNynIoKyvdIi3BUyWVZu1
|
||||
SMS_SIGN_NAME=苏州算力
|
||||
SMS_TEMPLATE_CODE=SMS_501590956
|
||||
EOF
|
||||
|
||||
# 启动后端
|
||||
cd backend
|
||||
nohup python3 -m uvicorn app.main:app --host 0.0.0.0 --port 3000 > /tmp/backend.log 2>&1 &
|
||||
|
||||
# 复制静态文件
|
||||
mkdir -p /var/www/html/static
|
||||
cp -r ../static/* /var/www/html/static/
|
||||
chmod -R 755 /var/www/html/static
|
||||
|
||||
# 配置Nginx
|
||||
cat > /etc/nginx/conf.d/jiachenlong-test.conf << 'EOF'
|
||||
server {
|
||||
listen 80;
|
||||
server_name _;
|
||||
|
||||
root /var/www/html;
|
||||
index index.html;
|
||||
|
||||
client_max_body_size 20M;
|
||||
|
||||
location /static {
|
||||
alias /var/www/html/static;
|
||||
}
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /api {
|
||||
proxy_pass http://127.0.0.1:3000/api;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
nginx -t && systemctl enable nginx && systemctl restart nginx
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 问题1: Logo不显示
|
||||
|
||||
**原因:**
|
||||
1. Nginx未配置`/static`路径，SPA路由捕获了请求
|
||||
2. 静态文件在`/root`目录下，nginx无权限读取
|
||||
|
||||
**解决:**
|
||||
1. 添加`location /static`配置
|
||||
2. 将静态文件复制到`/var/www/html/static`
|
||||
|
||||
### 问题2: 短信发送失败 "找不到模板"
|
||||
|
||||
**原因:** sms.py中的默认配置未更新
|
||||
|
||||
**解决:** 修改`backend/app/services/sms.py`:
|
||||
```python
|
||||
SMS_CONFIG = {
|
||||
"access_key_id": os.getenv("SMS_ACCESS_KEY_ID", "LTAI5tQAx5niD7JQVqGE5acE"),
|
||||
"access_key_secret": os.getenv("SMS_ACCESS_KEY_SECRET", "QsQFAEKBkaNynIoKyvdIi3BUyWVZu1"),
|
||||
"sign_name": os.getenv("SMS_SIGN_NAME", "苏州算力"),
|
||||
"template_code": os.getenv("SMS_TEMPLATE_CODE", "SMS_501590956"),
|
||||
}
|
||||
```
|
||||
|
||||
### 问题3: 数据库连接失败 "Ident authentication failed"
|
||||
|
||||
**原因:** PostgreSQL默认使用ident认证
|
||||
|
||||
**解决:**
|
||||
```bash
|
||||
sed -i 's/ident/trust/g' /var/lib/pgsql/data/pg_hba.conf
|
||||
systemctl restart postgresql
|
||||
```
|
||||
|
||||
## 验证命令
|
||||
|
||||
```bash
|
||||
# 测试机1验证
|
||||
curl -s -o /dev/null -w "%{http_code}" http://47.103.29.111/
|
||||
curl -s -o /dev/null -w "%{http_code}" http://47.103.29.111/static/images/jiachenlong-logo.png
|
||||
|
||||
# 测试机2验证
|
||||
curl -s http://47.103.9.192:3000/
|
||||
curl -s -o /dev/null -w "%{http_code}" http://47.103.9.192/static/images/jiachenlong-logo.png
|
||||
```
|
||||
|
||||
## 短信配置
|
||||
|
||||
| 项目 | 值 |
|
||||
|------|-----|
|
||||
| 模板Code | SMS_501590956 |
|
||||
| 签名 | 苏州算力 |
|
||||
| AccessKey ID | LTAI5tQAx5niD7JQVqGE5acE |
|
||||
| AccessKey Secret | QsQFAEKBkaNynIoKyvdIi3BUyWVZu1 |
|
||||
Loading…
Reference in New Issue