# 在 Docker 中运行 Cloudpods 快速指南

## 前置条件
- Docker Desktop 已安装并运行
- 至少 8GB 内存分配给 Docker
- 至少 50GB 磁盘空间

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

### 1. 进入 compose 目录
```bash
cd ocboot/compose
```

### 2. 修改配置（可选）
编辑 `docker-compose.yml` 文件，修改以下内容：
- `MYSQL_ROOT_PASSWORD`: 修改数据库密码（默认：your-sql-password）
- 其他环境变量根据需要调整

### 3. 启动所有服务
```bash
docker-compose up -d
```

### 4. 查看服务状态
```bash
docker-compose ps
```

### 5. 查看日志
```bash
# 查看所有服务日志
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. 停止服务
```bash
docker-compose down
```

### 8. 完全清理（包括数据）
```bash
docker-compose down -v
rm -rf data/
```

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

### 1. 生成配置文件
```bash
cd ocboot
python3 generate-compose.py > my-compose.yml
```

### 2. 自定义版本
```bash
# 指定版本
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. 使用生成的配置启动
```bash
docker-compose -f my-compose.yml up -d
```

## 常见问题

### 1. 端口冲突
如果遇到端口冲突，修改 `docker-compose.yml` 中的端口映射：
```yaml
ports:
  - "30300:30300"  # 改为 "8080:30300"
```

### 2. 内存不足
在 Docker Desktop 设置中增加内存分配：
- 打开 Docker Desktop
- Settings -> Resources -> Memory
- 建议至少 8GB

### 3. 服务启动失败
检查日志找出原因：
```bash
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/