Cloudpods/QUICKSTART.md

Cloudpods 快速开始

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

1. 克隆代码

git clone <repository-url>
cd Cloudpods

2. 安装 MySQL

确保 MySQL 已安装并启动：

# 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. 配置数据库

复制并编辑配置文件：

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

修改数据库密码（如果有）：

DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=你的MySQL密码  # 没有密码就留空

4. 初始化数据库

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

5. 编译后端

cd backend
make

6. 准备 etcd（非 macOS 用户）

macOS 用户跳过此步骤

Linux 用户：

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 backend/dev-scripts/start-services.sh start

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

8. 启动前端（可选）

cd frontend
pnpm install
pnpm run dev

9. 访问系统

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

登录信息：

• 用户名：sysadmin
• 密码：sysadmin
• 域：Default

常用命令

# 查看服务状态
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

服务端口

• 前端：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