零基础必看!Seatunnel Web 源码编译指南
零基础必看!Seatunnel Web 源码编译指南
文章目录
- 零基础必看!Seatunnel Web 源码编译指南
- 下载 Seatunnels
- 安装插件
- 验证是否启动成功
- 下载 Seatunnel Web 源码
- 配置 Seatunnel Web
- 初始化 MySQL
- 修改项目MySQL配置
- 修改JWT值
- 配置启动参数
- Build 项目
- 配置环境变量
- 配置 MySQL 依赖
- 启动 Seatunnel Web 后端服务
- 启动 Seatunnel Web 前端服务
在 Windows 环境中搭建和开发 Seatunnel Web 涉及多个步骤。本文将详细介绍从下载 Seatunnel、安装插件、配置环境到启动 Seatunnel Web 服务的全过程。通过本教程,您可以在本地环境中成功运行 Seatunnel Web,并进行进一步的开发和调试。
下载 Seatunnels
首先,需要从官方的下载页面获取 Seatunnel 的安装包:https://seatunnel.apache.org/download/
下载后,解压安装包,并进入解压后的文件夹。解压步骤完成后,您便可以开始安装和配置 Seatunnel。
安装插件
安装所需插件。打开终端窗口,进入到 Seatunnel 解压目录的 bin 文件夹,然后执行以下命令来安装插件:
.\bin\install-plugin.cmd ```避坑实录|  ### 启动 Seatunnel 安装完成后,可以启动 Seatunnel 服务。使用以下命令启动 Seatunnel: ```Bash .\bin\seatunnel-cluster.cmd -d
此命令将启动 Seatunnel 集群服务并进入后台模式。
验证是否启动成功
为了确保 Seatunnel 启动成功,执行以下命令运行一个简单程序验证运行状态:
.\bin\seatunnel.cmd --config ./config/v2.batch.config.template -m local
运行成功可以看到日志
50953630433281] 2025-05-12 21:28:09,243 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281), Pipeline: [(1/1)] future complete with state FINISHED [974150953630433281] 2025-05-12 21:28:09,244 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281) turned from state RUNNING to FINISHED. [974150953630433281] 2025-05-12 21:28:09,244 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281) state process is stop [] 2025-05-12 21:28:09,267 INFO org.apache.seatunnel.engine.client.job.ClientJobProxy - Job (974150953630433281) end with state FINISHED [] 2025-05-12 21:28:09,324 INFO org.apache.seatunnel.core.starter.seatunnel.command.ClientExecuteCommand - *********************************************** Job Statistic Information *********************************************** Start Time : 2025-05-12 21:28:06 End Time : 2025-05-12 21:28:09 Total Time(s) : 3 Total Read Count : 32 Total Write Count : 32 Total Failed Count : 0 ***********************************************
下载 Seatunnel Web 源码
Seatunnel Web 是 Seatunnel 的 Web 管理界面,可以方便地监控和管理数据任务。您可以从 GitHub 下载 Seatunnel Web 的源码:https://github.com/apache/seatunnel-web
下载完成后,使用 IntelliJ IDEA 或其他 IDE 打开项目。
配置 Seatunnel Web
初始化 MySQL
Seatunnel Web 需要 MySQL 数据库来存储任务和配置等信息。您需要导入 seatunnel-server/seatunnel-app/src/main/resources/script/seatunnel_server_mysql.sql 文件到数据库。该 SQL 文件将自动创建所需的数据库和表。
修改项目MySQL配置
修改 Seatunnel Web 的配置文件,指定 MySQL 数据库的连接信息。找到 application.yml 文件,修改 datasource 配置:
spring: application: name: seatunnel jackson: date-format: yyyy-MM-dd HH:mm:ss datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/seatunnel?useSSL=false&useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&allowPublicKeyRetrieval=true username: root password: root
修改JWT值
Seatunnel Web 使用 JWT(JSON Web Token)来进行用户身份验证。你可以选择使用默认的密钥值,也可以根据需要更改它。修改 jwt 配置:
jwt: expireTime: 86400 # please add key when deploy secretKey: n2r5u8x/A?D(G+KbPeShVmYq3s6v9y$B&E)H@McQfTjWnZr4u7w!z%C*F-JaNdRgU algorithm: HS256
配置启动参数
在启动类seatunnel-server/seatunnel-app/src/main/java/org/apache/seatunnel/app/SeatunnelApplication.java中配置
-DSEATUNNEL_HOME=D:\apache-seatunnel-2.3.8
Build 项目
启动时需要配置Build后的文件
.\build.cmd code
build成功后会出现这个目录:seatunnel-web-dist/target/apache-seatunnel-web-1.0.3-SNAPSHOT/apache-seatunnel-web-1.0.3-SNAPSHOT
配置环境变量
配置环境变量 ST_WEB_BASEDIR_PATH,将其指向构建后的文件路径:
ST_WEB_BASEDIR_PATH : D:\IDEAProjects\stweb\seatunnel-web-dist\target\apache-seatunnel-web-1.0.3-SNAPSHOT\apache-seatunnel-web-1.0.3-SNAPSHOT
配置 MySQL 依赖
编辑 seatunnel-server/seatunnel-app/pom.xml 文件,确保将 MySQL 依赖的 配置项从 test 移除:
mysql mysql-connector-java ${mysql.version}
启动 Seatunnel Web 后端服务
启动后端服务,通过seatunnel-server/seatunnel-app/src/main/java/org/apache/seatunnel/app/SeatunnelApplication.java启动类运行。
成功启动后,您将看到类似如下的日志,表示服务已成功启动:
启动 Seatunnel Web 前端服务
进入前端项目目录 seatunnel-ui,并使用以下命令安装依赖并启动前端服务:
cd seatunnel-ui npm install npm run dev
成功启动后,您将看到以下信息,表明前端服务已经启动,并可以通过浏览器访问:
VITE v4.5.5 ready in 1742 ms ➜ Local: http://localhost:5173/ ➜ Network: use --host to expose ➜ press h to show help
默认账号和密码为:admin/admin。访问 http://localhost:5173/,输入账号密码即可登录。
通过本教程,您已成功在 Windows 环境中搭建并运行了 Seatunnel 和 Seatunnel Web 服务。接下来,您可以根据需求进行二次开发 Seatunnel Web。希望本文对您的开发工作有所帮助!