Dinky项目本地开发环境搭建与调试指南

Dinky项目本地开发环境搭建与调试指南

【免费下载链接】dinky Dinky is an out-of-the-box, one-stop, real-time computing platform dedicated to the construction and practice of Unified Streaming & Batch and Unified Data Lake & Data Warehouse. Based on Apache Flink, Dinky provides the ability to connect many big data frameworks including OLAP and Data Lake. 项目地址: https://gitcode.com/gh_mirrors/di/dinky

前言

Dinky作为一款基于Flink的实时计算平台，为开发者提供了丰富的功能和灵活的扩展能力。本文将详细介绍如何在本地搭建Dinky的开发环境，帮助开发者快速上手项目开发与调试。

环境准备

基础软件要求

在开始之前，请确保您的开发机已安装以下软件：

1. 版本控制工具：Git用于代码版本管理
2. Java开发环境：JDK 8或11版本
3. 构建工具：Maven 3.8+版本
4. 前端开发环境：Node.js 18+版本和npm 10+
5. 数据库：MySQL 5.7+/PostgreSQL 15或H2数据库
6. 开发IDE：推荐使用IntelliJ IDEA 2023.2+版本
7. Lombok插件：IDEA插件，简化Java代码

环境配置建议

对于Java开发者，建议使用JDK 11以获得更好的开发体验。前端开发者推荐使用nvm管理Node.js版本，确保版本兼容性。

项目初始化

代码获取

通过Git工具获取Dinky项目源码，建议在专门的开发目录中操作：

mkdir dev_workspace
cd dev_workspace
git clone <项目仓库地址>

IDE导入

1. 打开IntelliJ IDEA，选择"Open"选项
2. 导航到已克隆的Dinky项目根目录
3. 等待项目索引完成
4. 确认JDK和Maven配置正确

前端环境配置

依赖安装

进入dinky-web目录，执行以下命令安装前端依赖：

npm install --force

启动前端服务

在dinky-web目录下执行：

npm run dev

或者直接在IDEA中打开package.json文件，点击dev脚本旁的运行按钮。

后端环境配置

Maven Profile详解

Dinky使用Maven Profile管理不同环境下的构建配置，主要Profile包括：

1. dev：开发环境配置，包含完整依赖
2. prod：生产环境配置，排除部分依赖
3. flink-1.14到flink-1.19：指定Flink版本
4. scala-2.11/scala-2.12：指定Scala版本
5. jdk11：指定使用JDK 11编译
6. fast：跳过代码检查，加速构建

首次构建

首次开发时，建议执行以下步骤：

1. 勾选dev、flink-all和对应Flink版本的Profile
2. 在Maven面板中执行Lifecycle > Install
3. 等待构建完成，生成必要的本地依赖

数据库配置

配置文件修改

以MySQL为例，需要修改以下文件：

1. application-mysql.yml：配置数据库连接信息
2. application.yml：设置激活的Profile为mysql

数据库初始化

1. 创建数据库和用户
2. 执行script/sql/dinky-mysql.sql初始化脚本
3. 如需升级，按版本顺序执行upgrade目录下的SQL文件

启动与调试

后端服务启动

在IDEA中直接运行dinky-admin模块下的主类Dinky，观察控制台输出确认启动成功。

访问系统

1. 前端默认运行在8000端口
2. 访问http://localhost:8000
3. 默认账号：admin/dinky123!@#

开发模式选择

Dinky支持两种开发模式：

1. provided模式：适合最终打包部署，依赖外部Flink环境
2. compile模式：适合本地开发调试，使用Flink local模式

常见问题处理

1. 构建失败：检查Profile配置是否正确，特别是Flink版本不能多选
2. 前端启动问题：确认Node.js版本符合要求
3. 数据库连接问题：检查配置文件中的连接参数
4. JDK版本问题：确保IDEA中配置的JDK与Profile匹配

开发建议

1. 开发新功能时基于dev分支
2. 修改代码后先执行本地测试
3. 遵循项目代码规范
4. 复杂修改建议分多次提交

通过以上步骤，您应该已经成功搭建了Dinky的本地开发环境，可以开始进行功能开发和调试工作了。

【免费下载链接】dinky Dinky is an out-of-the-box, one-stop, real-time computing platform dedicated to the construction and practice of Unified Streaming & Batch and Unified Data Lake & Data Warehouse. Based on Apache Flink, Dinky provides the ability to connect many big data frameworks including OLAP and Data Lake. 项目地址: https://gitcode.com/gh_mirrors/di/dinky