尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
SeaTunnel Edge Agent 下载与二进制包构建指南:从官方 Tarball 到源码打包
SeaTunnel Edge Agent 下载与二进制包构建指南从官方 Tarball 到源码打包【免费下载链接】seatunnelSeaTunnel is a multimodal, high-performance, distributed, massive data integration tool.项目地址: https://gitcode.com/GitHub_Trending/se/seatunnel本文基于 SeaTunnel 官方文档 Download And Build Edge Agent Package系统讲解如何为 SeaTunnel Edge Agent 准备边缘主机环境、获取二进制发行包官方 tarball 或从源码构建、并验证包布局的完整流程。读完本文你将能够独立完成 Edge Agent 的安装准备、包获取与结构核验并理解发行包中bin/、config/、starter/各目录的来源与启动脚本的运行时约定为后续的本地 Console 测试和生产环境 Agent → Engine 部署打下基础。什么是 Edge Agent 发行包Edge Agent 是 SeaTunnel 的轻量级边缘端采集组件它读取本地数据源如日志文件将出站数据缓冲在 SQLite WALWrite-Ahead Log队列中再通过 EdgeSocket 行协议把批次转发给 SeaTunnel Engine。其模块划分见 seatunnel-edge-agent 模块说明seatunnel-edge-agent-connector/EdgeInputReaderSPI提供file采集器seatunnel-edge-agent-transport/EdgeCollectorTransportSPIEdgeSocket / console与负载编码seatunnel-edge-agent-starter/配置解析、运行时、调度器、WAL 与源位点持久化bin/seatunnel-edge-agent.sh/seatunnel-edge-agent.cmd启动脚本config/示例agent.yaml与log4j2.properties。关键前提是Edge Agent 并不要求同一台机器上安装完整的 SeaTunnel Engine 发行版。它是独立于apache-seatunnel-version-bin.tar.gz单独发布的 tarballapache-seatunnel-edge-agent-version-bin.tar.gz第 1 步边缘主机环境准备在安装 Edge Agent 之前需要为边缘主机准备三项条件准备项要求说明JavaJava 8 或 11更新的 LTS 版本通常可用并设置JAVA_HOME启动脚本通过java运行starter/下的 fat jar磁盘可写目录用于存放queue.sqlite-path默认data/wal.db含 WAL 与源位点以及日志网络边缘主机到output.endpoint的出方向连通性即配置中 EdgeSocket 端点所在地址仅本地 Console 验证时可不满足其中 WAL 持久化文件wal.db、wal.db-wal、wal.db-shm与edge-agent.id身份文件都会创建在安装根目录下因此安装目录必须可写。第 2 步下载官方二进制包在官方下载渠道可用时获取对应版本的 tarball 并解包export versionseatunnel-version wget https://archive.apache.org/dist/seatunnel/${version}/apache-seatunnel-edge-agent-${version}-bin.tar.gz tar -xzf apache-seatunnel-edge-agent-${version}-bin.tar.gz cd apache-seatunnel-edge-agent-${version}解包后安装根目录install root就是包含bin/、config/、starter/三个子目录的那一层。约定在后续部署文档中EDGE_AGENT_HOME均指代该安装根目录。启动脚本会基于脚本自身位置解析路径见下文源码分析因此功能上不依赖该变量但出于运维规范和 systemd 单元配置的需要仍建议显式导出EDGE_AGENT_HOME。快速开始的完整流程参见 Quick Start生产部署参见 Deployment Guide。第 3 步从源码构建二进制包在没有官方发行包、或需要尝鲜未发布特性时可以直接从 SeaTunnel 源码仓库构建。当前仓库根pom.xml中revision为3.0.0-SNAPSHOT因此源码构建产出的 tarball 版本号为快照版本构建发布版请使用对应 release 分支。git clone seatunnel 仓库地址 cd seatunnel ./mvnw clean package -pl seatunnel-dist -am -DskipTests -Dskip.spotlesstrue构建成功后产物位于seatunnel-dist/target/apache-seatunnel-edge-agent-version-bin.tar.gz将 tarball 拷贝到边缘主机按第 2 步的方式解包即可。打包机制seatunnel-dist中的 assembly 描述符上述命令之所以能产出 Edge Agent 专用 tarball是因为seatunnel-dist模块内注册了独立的 assembly execution。在 seatunnel-dist/pom.xml 中edge-agent-binexecution 使用描述符 assembly-edge-agent-bin.xml并指定finalName为apache-seatunnel-edge-agent-${project.version}CI 场景下则使用 assembly-edge-agent-bin-ci.xml。该描述符精确决定了发行包的内容包内路径来源说明README.md../seatunnel-edge-agent/README.md模块级说明指向文档站点的完整用户指南bin/权限 0755../seatunnel-edge-agent/binseatunnel-edge-agent.sh与seatunnel-edge-agent.cmdassembly 中显式设置fileMode 0755config/../seatunnel-edge-agent/config示例 agent.yaml 与log4j2.propertiesstarter/seatunnel-edge-agent-starter.jar依赖org.apache.seatunnel:seatunnel-edge-agent-starter内置输入、传输与负载插件的 fat jarstarter/logging/slf4j-api、jcl-over-slf4j、log4j-api、log4j-core、log4j-slf4j-impl独立的日志依赖目录LICENSE、NOTICE、licenses/release-docs/许可证与第三方许可清单从该描述符可以印证文档中的两条重要说明没有lib/目录。assembly 中没有任何lib/输出项——官方 tarball 不包含lib/。只有在自行构建并分发扩展插件时才需要在解包后手工创建lib/放入自定义插件 JAR进阶用法。没有插件安装步骤。与主发行版的bin/install-plugin.sh不同Edge Agent 包不提供该脚本内置的 input、transport、payload 插件已经打包进seatunnel-edge-agent-starter.jar解压即可用无需二次安装连接器。第 4 步验证包布局解包后应核对以下结构以官方 tarball 为准apache-seatunnel-edge-agent-version/ bin/ seatunnel-edge-agent.sh seatunnel-edge-agent.cmd config/ agent.yaml # sample configuration log4j2.properties starter/ seatunnel-edge-agent-starter.jar logging/ # logging dependencies README.md扩展进阶默认 tarball 没有lib/目录。自定义插件 JAR 只有在自行构建并发放扩展时才会被放置在lib/下。启动脚本如何解析路径seatunnel-edge-agent.sh 开头的几行源码印证了“脚本基于自身位置解析路径”的设计同时也暴露了一组可用于运维覆盖的环境变量BASE_DIR$(cd $(dirname ${BASH_SOURCE[0]})/.. pwd) DEFAULT_CONF_FILE${BASE_DIR}/config/agent.yaml CONF_FILE${EDGE_AGENT_CONFIG:-${DEFAULT_CONF_FILE}} PID_FILE${EDGE_AGENT_PID_FILE:-${BASE_DIR}/edge-agent.pid} ID_FILE${EDGE_AGENT_ID_FILE:-${BASE_DIR}/edge-agent.id} LOG_FILE${EDGE_AGENT_LOG_FILE:-${BASE_DIR}/edge-agent.out} ... MAIN_CLASSorg.apache.seatunnel.edge.agent.starter.EdgeAgentStarter APP_JAR${BASE_DIR}/starter/seatunnel-edge-agent-starter.jar由此可确认主类为org.apache.seatunnel.edge.agent.starter.EdgeAgentStarter运行入口就是starter/目录下的 fat jar配置文件默认取config/agent.yaml可通过EDGE_AGENT_CONFIG指向外部配置方便 systemd 多实例部署edge-agent.idAgent 身份文件默认位于安装根目录迁移或续跑测试时应保留该文件与data/目录含wal.db及其-wal/-shm文件脚本支持start | stop | status | db | help命令其中db子命令可对 WAL SQLite 库做运维查询对应源码中的command/db/包见 EdgeAgentDbCommand 一族类。示例配置 agent.yaml 中默认output.type: console数据经应用日志输出到log/edge-agent.log便于本地调试生产环境需切换为type: transport并配置endpoint、token等必填项完整参数参考 Configuration。常见问题与注意事项版本占位符命令中的seatunnel-version/version需替换为实际版本源码构建时以仓库revision为准当前为3.0.0-SNAPSHOT。构建耗时-pl seatunnel-dist -am会连带构建上游依赖模块首次构建较慢-Dskip.spotlesstrue仅跳过代码格式检查不影响包内容。不要混用发行包Edge Agent tarball 与主引擎发行包互相独立边缘主机无需也不应假设有seatunnel.sh、install-plugin.sh等主发行版组件向 Engine 提交作业时使用的是 Engine 侧的./bin/seatunnel.sh --config ...。身份与数据目录无论是否连接 EngineAgent 都会创建edge-agent.id与data/下的 WAL 持久化文件备份迁移时请一并保留详见 FAQ。后续步骤Quick Start无 Engine 的本地 Console 验证BOOTSTRAP_READY→ 追加日志行 → 查看EDGE_CONSOLE_OUTPUT以及带 Engine 的生产链路最小验证Deployment Guide生产部署与 systemd 化Configurationagent.yaml全量参数WAL 队列、重试、传输超时与packet-mode压缩/加密等EdgeSocket SourceEngine 侧线协议说明。【免费下载链接】seatunnelSeaTunnel is a multimodal, high-performance, distributed, massive data integration tool.项目地址: https://gitcode.com/GitHub_Trending/se/seatunnel创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

Security-101 基础设施安全能力全解:漏洞管理、CSPM 与 CNAPP 实战指南

Security-101 基础设施安全能力全解:漏洞管理、CSPM 与 CNAPP 实战指南

Security-101 基础设施安全能力全解:漏洞管理、CSPM 与 CNAPP 实战指南 【免费下载链接】Security-101 8 Lessons, Kick-start Your Cybersecurity Learning. 项目地址: https://gitcode.com/GitHub_Trending/se/Security-101 导读:本文以 Securit…

📅 2026/9/17 12:42:12
TorchTitan 开发指南:构建测试流程、数值验证规范与代码风格约定

TorchTitan 开发指南:构建测试流程、数值验证规范与代码风格约定

TorchTitan 开发指南:构建测试流程、数值验证规范与代码风格约定 【免费下载链接】torchtitan A PyTorch native platform for training generative AI models 项目地址: https://gitcode.com/GitHub_Trending/to/torchtitan 本文为 TorchTitan(M…

📅 2026/9/17 12:42:12
智能家居系统设计:从规则引擎到AI决策架构的实践指南

智能家居系统设计:从规则引擎到AI决策架构的实践指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/17 12:42:12
MORE NEWS

更多资讯

📰

RoPE复数形式全解:旋转位置编码的几何意义与注意力分数推导

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

代码转流程图:开发者的逻辑可视化刚需工具指南

1. 为什么“代码转流程图”不是锦上添花,而是开发日常的刚需?你有没有过这样的经历:接手一个没人维护的老项目,打开源码——满屏嵌套三层以上的 if-else、十几层缩进的 for 循环、函数调用链像迷宫一样绕来绕去?光看代…

📰

机械臂仿真链路:从URDF到Simscape再到S-Function的完整实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

Git SSH密钥配置、ed25519与多账号排查指南

周六下午,同事在群里甩过来一句"git push 一直报 Permission denied (publickey)",配了张终端截图。我扫了一眼就知道,又是 SSH 密钥没配明白。这类问题从我第一次自己搭 Git 仓库到现在,前前后后大概处理过几百次,踩过的坑能写满一整页笔记。git 中的 SSH 密钥的配置…

📰

Dev-C++ 5.11 安装配置与使用指南:从下载到调试的完整教程

大学生涯里,你大概率会在一门叫“C语言程序设计”的课上第一次认识Dev-C。这个蓝白色调、界面看起来跟时代脱节的IDE,最新稳定版本Orwell Dev-C 5.11发布已经快十年了,可你去任何一所高校的计算机机房看,桌面上十有八九还躺着这个…

📰

IEPE传感器全解析:从压电效应到工程实践的振动测量指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬