# 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. 启动���务

```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. 处理方法

- 检查容器日志
- 验证配置文件
- 检查��源使用
- 查看系统日志

## 维护计划

### 1. 日常维护

- 日志清理
- 磁盘空间检查
- 性能监控
- 配置备份

### 2. 定期更新

- 安全补丁更新
- 基础镜像更新
- 应用版本更新