122 lines
2.9 KiB
Markdown
122 lines
2.9 KiB
Markdown
|
# 云南智慧牛产业平台 - 部署与运维文档
|
|||
|
|
|
|||
|
|
## 1. 部署环境
|
|||
|
|
- **操作系统**: CentOS 10 64位
|
|||
|
|
- **Web服务器**: Nginx 1.24+
|
|||
|
|
- **容器引擎**: Docker 24.0+
|
|||
|
|
- **容器编排**: Docker Compose 2.20+
|
|||
|
|
|
|||
|
|
## 2. 目录结构规范
|
|||
|
|
服务器根目录建议为 `/opt/caiyunniu/`：
|
|||
|
|
```
|
|||
|
|
/opt/caiyunniu/
|
|||
|
|
├── docker-compose.yml # 容器编排文件
|
|||
|
|
├── nginx/
|
|||
|
|
│ ├── conf.d/ # Nginx 配置文件
|
|||
|
|
│ ├── certs/ # SSL 证书
|
|||
|
|
│ └── html/ # 前端静态资源
|
|||
|
|
│ ├── website/ # 官网构建产物 (dist)
|
|||
|
|
│ └── admin/ # 管理后台构建产物 (dist)
|
|||
|
|
├── mysql/
|
|||
|
|
│ ├── data/ # 数据库数据卷
|
|||
|
|
│ └── init/ # 初始化 SQL 脚本
|
|||
|
|
├── redis/
|
|||
|
|
│ └── data/ # Redis 数据卷
|
|||
|
|
└── logs/ # 应用日志
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 前端部署 (Website)
|
|||
|
|
|
|||
|
|
### 3.1 本地构建
|
|||
|
|
在开发机执行：
|
|||
|
|
```bash
|
|||
|
|
cd website
|
|||
|
|
npm install
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
构建完成后，生成的 `dist` 目录即为部署包。
|
|||
|
|
|
|||
|
|
### 3.2 上传文件
|
|||
|
|
将 `dist` 目录内容上传至服务器：
|
|||
|
|
```bash
|
|||
|
|
scp -r dist/* user@server_ip:/opt/caiyunniu/nginx/html/website/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.3 Nginx 配置示例
|
|||
|
|
```nginx
|
|||
|
|
server {
|
|||
|
|
listen 80;
|
|||
|
|
server_name www.caiyunniu.com;
|
|||
|
|
|
|||
|
|
# 强制跳转 HTTPS
|
|||
|
|
return 301 https://$host$request_uri;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
server {
|
|||
|
|
listen 443 ssl http2;
|
|||
|
|
server_name www.caiyunniu.com;
|
|||
|
|
|
|||
|
|
ssl_certificate /etc/nginx/certs/caiyunniu.pem;
|
|||
|
|
ssl_certificate_key /etc/nginx/certs/caiyunniu.key;
|
|||
|
|
|
|||
|
|
# 官网前端
|
|||
|
|
location / {
|
|||
|
|
root /usr/share/nginx/html/website;
|
|||
|
|
index index.html;
|
|||
|
|
try_files $uri $uri/ /index.html; # Vue Router History 模式支持
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 后端 API 代理
|
|||
|
|
location /api/ {
|
|||
|
|
proxy_pass http://backend-service:8080/;
|
|||
|
|
proxy_set_header Host $host;
|
|||
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 后端部署 (Backend)
|
|||
|
|
|
|||
|
|
### 4.1 Docker 镜像构建
|
|||
|
|
在后端项目根目录创建 `Dockerfile`：
|
|||
|
|
```dockerfile
|
|||
|
|
FROM openjdk:17-jdk-alpine
|
|||
|
|
VOLUME /tmp
|
|||
|
|
COPY target/*.jar app.jar
|
|||
|
|
ENTRYPOINT ["java","-jar","/app.jar"]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.2 Docker Compose 编排
|
|||
|
|
```yaml
|
|||
|
|
version: '3'
|
|||
|
|
services:
|
|||
|
|
backend-service:
|
|||
|
|
build: ./backend
|
|||
|
|
ports:
|
|||
|
|
- "8080:8080"
|
|||
|
|
environment:
|
|||
|
|
- SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/caiyunniu?useSSL=false
|
|||
|
|
- SPRING_REDIS_HOST=redis
|
|||
|
|
depends_on:
|
|||
|
|
- mysql
|
|||
|
|
- redis
|
|||
|
|
|
|||
|
|
mysql:
|
|||
|
|
image: mysql:8.0
|
|||
|
|
environment:
|
|||
|
|
MYSQL_ROOT_PASSWORD: strong_password
|
|||
|
|
volumes:
|
|||
|
|
- ./mysql/data:/var/lib/mysql
|
|||
|
|
|
|||
|
|
redis:
|
|||
|
|
image: redis:6.0
|
|||
|
|
volumes:
|
|||
|
|
- ./redis/data:/data
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 5. 运维常用命令
|
|||
|
|
- **启动所有服务**: `docker-compose up -d`
|
|||
|
|
- **查看日志**: `docker-compose logs -f backend-service`
|
|||
|
|
- **重启服务**: `docker-compose restart backend-service`
|
|||
|
|
- **Nginx 重载配置**: `docker exec -it nginx nginx -s reload`
|