Cloudpods/ocboot/DOCKER_QUICKSTART.md

在 Docker 中运行 Cloudpods 快速指南

前置条件

• Docker Desktop 已安装并运行
• 至少 8GB 内存分配给 Docker
• 至少 50GB 磁盘空间

方法 1：使用 Docker Compose（推荐）

1. 进入 compose 目录

cd ocboot/compose

2. 修改配置（可选）

编辑 docker-compose.yml 文件，修改以下内容：

• MYSQL_ROOT_PASSWORD: 修改数据库密码（默认：your-sql-password）
• 其他环境变量根据需要调整

3. 启动所有服务

docker-compose up -d

4. 查看服务状态

docker-compose ps

5. 查看日志

# 查看所有服务日志
docker-compose logs -f

# 查看特定服务日志
docker-compose logs -f keystone
docker-compose logs -f region

6. 访问 Web 界面

等待所有服务启动完成后（大约 5-10 分钟），访问：

• Web 控制台: http://localhost:30300
• 默认用户名: admin
• 默认密码: admin@123

7. 停止服务

docker-compose down

8. 完全清理（包括数据）

docker-compose down -v
rm -rf data/

方法 2：生成自定义 Docker Compose 配置

1. 生成配置文件

cd ocboot
python3 generate-compose.py > my-compose.yml

2. 自定义版本

# 指定版本
VERSION=v4.0.2 python3 generate-compose.py > my-compose.yml

# 指定产品版本
PRODUCT_VERSION=CMP VERSION=v4.0.2 python3 generate-compose.py > my-compose.yml

3. 使用生成的配置启动

docker-compose -f my-compose.yml up -d

常见问题

1. 端口冲突

如果遇到端口冲突，修改 docker-compose.yml 中的端口映射：

ports:
  - "30300:30300"  # 改为 "8080:30300"

2. 内存不足

在 Docker Desktop 设置中增加内存分配：

• 打开 Docker Desktop
• Settings -> Resources -> Memory
• 建议至少 8GB

3. 服务启动失败

检查日志找出原因：

docker-compose logs <service-name>

4. 数据持久化

数据存储在 ./data 目录中，包括：

• MySQL 数据: ./data/var/lib/mysql
• InfluxDB 数据: ./data/var/lib/influxdb
• Glance 镜像: ./data/opt/cloud/workspace/data/glance

注意事项

⚠️ 重要提示：

1. Docker Compose 方式主要用于开发和测试环境
2. 生产环境建议使用 Kubernetes 部署方式
3. 首次启动需要下载大量镜像，请耐心等待
4. macOS 上运行性能可能不如 Linux 原生环境
5. 某些功能（如裸金属管理）在容器中可能受限

下一步

启动成功后，你可以：

1. 登录 Web 控制台
2. 创建虚拟机
3. 配置云账号（AWS、Azure、阿里云等）
4. 查看监控数据

更多文档请访问：https://www.cloudpods.org/