233 lines
3.9 KiB
Markdown
233 lines
3.9 KiB
Markdown
# Docker 部署设计文档
|
||
|
||
本文档详细说明碰撞避免系统的 Docker 部署方案，包括测试环境和生产环境的部署流程。
|
||
|
||
## 环境说明
|
||
|
||
### 测试环境
|
||
|
||
- CentOS 7
|
||
- 可以访问互联网
|
||
- 可以安装软件包
|
||
- 内存 >= 4GB
|
||
- 磁盘空间 >= 20GB
|
||
|
||
### 生产环境
|
||
|
||
- CentOS 7
|
||
- 不能访问互联网
|
||
- 不能在线安装软件包
|
||
- 内存 >= 8GB
|
||
- 磁盘空间 >= 50GB
|
||
|
||
## 测试环境工作
|
||
|
||
### 1. 环境准备
|
||
|
||
```bash
|
||
# 安装 Docker
|
||
curl -fsSL https://get.docker.com | sh
|
||
systemctl enable docker
|
||
systemctl start docker
|
||
|
||
# 安装 Docker Compose
|
||
curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
|
||
chmod +x /usr/local/bin/docker-compose
|
||
```
|
||
|
||
### 2. 镜像构建与测试
|
||
|
||
1. 构建基础镜像
|
||
2. 运行自动化测试
|
||
3. 验证功能完整性
|
||
4. 检查资源使用情况
|
||
5. 验证日志收集
|
||
6. 测试健康检查机制
|
||
|
||
### 3. 准备生产部署包
|
||
|
||
1. 导出 Docker 镜像
|
||
|
||
```bash
|
||
# 保存基础镜像
|
||
docker save centos:7 > centos7-base.tar
|
||
|
||
# 保存应用镜像
|
||
docker save collision-avoidance:latest > collision-avoidance.tar
|
||
```
|
||
|
||
2. 准备离线安装包
|
||
|
||
```bash
|
||
# 创建部署包目录
|
||
mkdir -p offline-package
|
||
cd offline-package
|
||
|
||
# 下载 Docker 离线安装包
|
||
yum install -y yum-utils
|
||
yumdownloader --resolve docker-ce docker-ce-cli containerd.io
|
||
|
||
# 下载 Docker Compose 二进制文件
|
||
wget https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-x86_64
|
||
```
|
||
|
||
3. 创建部署脚本
|
||
|
||
```bash
|
||
# 打包所有文件
|
||
tar czf docker-deploy-package.tar.gz \
|
||
centos7-base.tar \
|
||
collision-avoidance.tar \
|
||
*.rpm \
|
||
docker-compose-Linux-x86_64 \
|
||
scripts/
|
||
```
|
||
|
||
## 生产环境工作
|
||
|
||
### 1. 离线安装 Docker
|
||
|
||
```bash
|
||
# 解压部署包
|
||
tar xzf docker-deploy-package.tar.gz
|
||
|
||
# 安装 Docker RPM 包
|
||
rpm -ivh *.rpm
|
||
|
||
# 安装 Docker Compose
|
||
cp docker-compose-Linux-x86_64 /usr/local/bin/docker-compose
|
||
chmod +x /usr/local/bin/docker-compose
|
||
|
||
# 启动 Docker 服务
|
||
systemctl enable docker
|
||
systemctl start docker
|
||
```
|
||
|
||
### 2. 加载 Docker 镜像
|
||
|
||
```bash
|
||
# 加载基础镜像
|
||
docker load < centos7-base.tar
|
||
|
||
# 加载应用镜像
|
||
docker load < collision-avoidance.tar
|
||
```
|
||
|
||
### 3. 部署配置
|
||
|
||
1. 创建数据目录
|
||
|
||
```bash
|
||
mkdir -p /data/collision-avoidance/{config,logs}
|
||
```
|
||
|
||
2. 配置文件准备
|
||
|
||
```bash
|
||
cp config/* /data/collision-avoidance/config/
|
||
```
|
||
|
||
### 4. 启动<E590AF><E58AA8><EFBFBD>务
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
## 部署后验证
|
||
|
||
### 1. 基础检查
|
||
|
||
- 容器状态
|
||
- 端口可用性
|
||
- 日志输出
|
||
- 资源使用情况
|
||
|
||
### 2. 功能验证
|
||
|
||
- WebSocket 连接测试
|
||
- Mock Server 功能测试
|
||
- 碰撞检测功能测试
|
||
- 数据持久化验证
|
||
|
||
### 3. 监控检查
|
||
|
||
- 健康检查状态
|
||
- 资源监控指标
|
||
- 日志收集状态
|
||
|
||
## 回滚方案
|
||
|
||
### 1. 准备回滚镜像
|
||
|
||
- 在测试环境保留上一个稳定版本镜像
|
||
- 将回滚镜像包含在部署包中
|
||
|
||
### 2. 回滚步骤
|
||
|
||
```bash
|
||
# 停止当前服务
|
||
docker-compose down
|
||
|
||
# 加载回滚镜像
|
||
docker load < collision-avoidance-rollback.tar
|
||
|
||
# 修改镜像标签
|
||
docker tag collision-avoidance-rollback:latest collision-avoidance:latest
|
||
|
||
# 重启服务
|
||
docker-compose up -d
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
### 1. 安全考虑
|
||
|
||
- 使用非 root 用户运行容器
|
||
- 配置文件权限控制
|
||
- 网络访问限制
|
||
- 资源限制设置
|
||
|
||
### 2. 性能优化
|
||
|
||
- 容器资源限制配置
|
||
- 日志轮转策略
|
||
- 数据持久化方案
|
||
|
||
### 3. 运维建议
|
||
|
||
- 定期备份配置文件
|
||
- 监控告警配置
|
||
- 日志管理策略
|
||
- 定期检查磁盘使用情况
|
||
|
||
## 故障处理
|
||
|
||
### 1. 常见问题
|
||
|
||
- 容器启动失败
|
||
- 端口冲突
|
||
- 资源不足
|
||
- 日志异常
|
||
|
||
### 2. 处理方法
|
||
|
||
- 检查容器日志
|
||
- 验证配置文件
|
||
- 检查<E6A380><E69FA5>源使用
|
||
- 查看系统日志
|
||
|
||
## 维护计划
|
||
|
||
### 1. 日常维护
|
||
|
||
- 日志清理
|
||
- 磁盘空间检查
|
||
- 性能监控
|
||
- 配置备份
|
||
|
||
### 2. 定期更新
|
||
|
||
- 安全补丁更新
|
||
- 基础镜像更新
|
||
- 应用版本更新
|