mkdocs/docs/技术文档/部署文档.md

部署文档

环境要求

• 操作系统: Linux (CentOS 7+)
• Docker: 20.10+
• Docker Compose: 1.29+
• 内存: 建议 4GB+
• 磁盘: 建议 50GB+

部署步骤

1. 安装 Docker 和 Docker Compose

# 安装 Docker
sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker

# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2. 克隆或创建项目目录

mkdir -p /home/renjianbo/devops
cd /home/renjianbo/devops

3. 启动各个服务

Gerrit

cd gerrit
docker-compose up -d

Gitea

cd gitea
docker-compose up -d

MinIO

cd minio
docker-compose up -d

Nexus

cd nexus
docker-compose up -d

Drone CI

cd drone-ci
docker-compose up -d

MkDocs

cd mkdocs
docker-compose up -d

4. 验证部署

# 检查所有容器状态
docker ps

# 检查端口监听
netstat -tlnp | grep -E "8000|8082|3000|9000|8081"

配置说明

端口映射

• Gerrit: 8082 (HTTP), 29418 (SSH)
• Gitea: 3000 (HTTP), 222 (SSH)
• MinIO: 9000 (API), 9001 (Console)
• Nexus: 8081 (HTTP)
• Drone CI: 3000 (HTTP)
• MkDocs: 8000 (HTTP)

数据持久化

所有服务的数据存储在 Docker 卷中，确保数据持久化。

备份和恢复

备份

# 备份所有数据
cd /home/renjianbo/devops
./scripts/backup.sh

恢复

# 恢复数据
cd /home/renjianbo/devops
./scripts/restore.sh

监控和维护

查看日志

# 查看特定服务日志
cd /home/renjianbo/devops/<服务名>
docker-compose logs -f

更新服务

# 拉取最新镜像
docker-compose pull

# 重启服务
docker-compose up -d

故障排查

端口冲突

如果端口被占用，修改 docker-compose.yml 中的端口映射。

权限问题

确保数据目录有正确的权限：

sudo chown -R $USER:$USER /home/renjianbo/devops/*/data

容器无法启动

查看容器日志：

docker logs <容器名>