# Cloudpods 快速开始

## 新同事开发环境搭建（5 分钟）

### 1. 克隆代码

```bash
git clone <repository-url>
cd Cloudpods
```

### 2. 安装 MySQL

确保 MySQL 已安装并启动：

```bash
# macOS
brew install mysql
brew services start mysql

# Ubuntu/Debian
sudo apt install mysql-server
sudo systemctl start mysql

# Windows (WSL)
sudo apt install mysql-server
sudo service mysql start
```

### 3. 配置数据库

复制并编辑配置文件：

```bash
# 配置文件已存在，直接编辑
vim .env.local
```

修改数据库密码（如果有）：
```bash
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=你的MySQL密码  # 没有密码就留空
```

### 4. 初始化数据库

```bash
bash backend/dev-scripts/init-database.sh
```

### 5. 编译后端

```bash
cd backend
make
```

### 6. 准备 etcd（非 macOS 用户）

**macOS 用户跳过此步骤**

**Linux 用户**：
```bash
cd backend/bin
curl -L https://github.com/etcd-io/etcd/releases/download/v3.6.10/etcd-v3.6.10-linux-amd64.tar.gz -o etcd.tar.gz
tar xzvf etcd.tar.gz
cp etcd-v3.6.10-linux-amd64/etcd* linux/
rm -rf etcd.tar.gz etcd-v3.6.10-linux-amd64
cd ../..
```

**Windows 用户**：建议使用 WSL，然后按 Linux 步骤操作

### 7. 启动后端服务

```bash
bash backend/dev-scripts/start-services.sh start
```

等待 30 秒，所有服务启动完成。

### 8. 启动前端（可选）

```bash
cd frontend
pnpm install
pnpm run dev
```

### 9. 访问系统

打开浏览器访问：http://localhost:8080

**登录信息**：
- 用户名：`sysadmin`
- 密码：`sysadmin`
- 域：`Default`

## 常用命令

```bash
# 查看服务状态
bash backend/dev-scripts/start-services.sh status

# 停止服务
bash backend/dev-scripts/start-services.sh stop

# 重启服务
bash backend/dev-scripts/start-services.sh restart

# 查看日志
tail -f backend/logs/keystone.log
tail -f backend/logs/region.log
tail -f backend/logs/apigateway.log
```

## 遇到问题？

查看详细文档：[backend/dev-scripts/README.md](backend/dev-scripts/README.md)

## 服务端口

- 前端：http://localhost:8080
- API Gateway：http://localhost:30300
- Keystone：http://localhost:35357
- Region：http://localhost:30888
- Glance：http://localhost:9292
- Yunionconf：http://localhost:30889
- etcd：http://localhost:2379
