快速开始

在开始使用 UniOne Cloud 之前，请确保您的环境满足以下要求：

• 操作系统：Windows 10/11、macOS 10.14+ 或 Linux (Ubuntu 18.04+, CentOS 7+)
• Java 环境：JDK 1.8 或更高版本
• Maven：3.6.0 或更高版本
• 数据库：MySQL 5.7 或更高版本
• Git：用于代码管理和更新

1. 克隆代码库

git clone https://github.com/unione/unione-cloud.git
cd unione-cloud

2. 配置数据库

创建数据库并导入初始化脚本：

mysql -u root -p
CREATE DATABASE unione DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE unione;
source db/mysql/unione-init.sql;

3. 配置环境变量

复制配置文件并修改数据库连接信息：

cp unione-starter/src/main/resources/application.properties.example unione-starter/src/main/resources/application.properties
# 编辑 application.properties 文件，修改数据库连接信息

4. 构建项目

mvn clean package -DskipTests

5. 启动服务

cd unione-starter/target
java -jar unione-starter.jar

使用 Docker 部署

如果您使用 Docker，可以使用以下命令快速部署：

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

UniOne Cloud 的主要配置文件位于 unione-starter/src/main/resources/application.properties，主要配置项包括：

数据库配置

# 数据库连接配置
spring.datasource.url=jdbc:mysql://localhost:3306/unione?useUnicode=true&characterEncoding=utf-8&useSSL=false
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

服务器配置

# 服务器端口配置
server.port=8080

# 上下文路径
server.servlet.context-path=/unione

# 会话超时设置
server.servlet.session.timeout=30m

日志配置

# 日志级别配置
logging.level.root=INFO
logging.level.com.unione=DEBUG

# 日志文件配置
logging.file.name=logs/unione.log
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

访问管理控制台

服务启动后，可以通过浏览器访问管理控制台：

默认的管理员账号和密码为：

创建第一个项目

1. 登录管理控制台
2. 点击左侧菜单的 "项目管理"
3. 点击 "新建项目" 按钮
4. 填写项目名称和描述
5. 选择项目类型和模板
6. 点击 "创建" 完成项目创建

API 调用示例

使用 curl 调用 UniOne Cloud API：

# 获取项目列表
curl -X GET "http://localhost:8080/unione/api/projects" \-H "Authorization: Bearer your_token"

# 创建新项目
curl -X POST "http://localhost:8080/unione/api/projects" \-H "Authorization: Bearer your_token" \-H "Content-Type: application/json" \-d '{"name":"新项目","description":"这是一个测试项目"}'

成功部署并运行 UniOne Cloud 后，您可以继续学习以下内容：