QDAirPortTestSystemBackend/docs/docker_deployment_design.md

Docker 部署设计文档

本文档详细说明碰撞避免系统的 Docker 部署方案，包括测试环境和生产环境的部署流程。

环境说明

测试环境

• CentOS 7
• 可以访问互联网
• 可以安装软件包
• 内存 >= 4GB
• 磁盘空间 >= 20GB

生产环境

• CentOS 7
• 不能访问互联网
• 不能在线安装软件包
• 内存 >= 8GB
• 磁盘空间 >= 50GB

测试环境工作

1. 环境准备

# 安装 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 镜像

# 保存基础镜像
docker save centos:7 > centos7-base.tar

# 保存应用镜像
docker save collision-avoidance:latest > collision-avoidance.tar

2. 准备离线安装包

# 创建部署包目录
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. 创建部署脚本

# 打包所有文件
tar czf docker-deploy-package.tar.gz \
    centos7-base.tar \
    collision-avoidance.tar \
    *.rpm \
    docker-compose-Linux-x86_64 \
    scripts/

生产环境工作

1. 离线安装 Docker

# 解压部署包
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 镜像

# 加载基础镜像
docker load < centos7-base.tar

# 加载应用镜像
docker load < collision-avoidance.tar

3. 部署配置

1. 创建数据目录

mkdir -p /data/collision-avoidance/{config,logs}

2. 配置文件准备

cp config/* /data/collision-avoidance/config/

4. 启动<E590AF><E58AA8><EFBFBD>务

docker-compose up -d

部署后验证

1. 基础检查

• 容器状态
• 端口可用性
• 日志输出
• 资源使用情况

2. 功能验证

• WebSocket 连接测试
• Mock Server 功能测试
• 碰撞检测功能测试
• 数据持久化验证

3. 监控检查

• 健康检查状态
• 资源监控指标
• 日志收集状态

回滚方案

1. 准备回滚镜像

• 在测试环境保留上一个稳定版本镜像
• 将回滚镜像包含在部署包中

2. 回滚步骤

# 停止当前服务
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. 处理方法

• 检查容器日志
• 验证配置文件
• 检查<EFBFBD><EFBFBD>源使用
• 查看系统日志

维护计划

1. 日常维护

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

2. 定期更新

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