sdelquin/webspoon

webSpoon Docker镜像文档

概述

webSpoon是Pentaho Data Integration (PDI) 图形化设计器Spoon的Web化实现。该Docker镜像提供了无需本地安装PDI客户端即可通过Web浏览器访问的图形化数据集成开发环境，简化了ETL（抽取、转换、加载）流程的设计、编辑与管理，适用于跨平台和远程协作场景。

核心功能与特性

• Web化访问：通过浏览器直接访问，无需安装本地Spoon客户端，支持跨设备访问
• 图形化设计界面：提供拖拽式可视化操作，支持ETL转换（.ktr）和作业（.kjb）的创建与编辑
• PDI兼容性：与Pentaho Data Integration完全兼容，支持PDI的核心功能和扩展插件
• 轻量级部署：基于Docker容器化部署，简化环境配置，降低依赖管理复杂度
• 跨平台支持：可在任何支持Docker的操作系统（Linux、Windows、macOS）上运行

使用场景与适用范围

• 数据集成开发人员需要远程或跨平台设计ETL流程
• 团队协作开发数据集成项目，共享设计环境
• 教学或培训场景中快速部署PDI图形化工具
• 中小型企业简化数据集成工具的部署与维护
• 需要临时或测试环境验证ETL流程设计

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动webSpoon容器：

bash
docker run -d -p 8080:8080 --name webspoon hiromuhota/webspoon

参数说明：

• -d：后台运行容器
• -p 8080:8080：将容器的8080端口映射到主机的8080端口
• --name webspoon：指定容器名称为webspoon
• hiromuhota/webspoon：官方Docker镜像名称

启动后，通过浏览器访问 http://<主机IP>:8080/spoon 即可打开webSpoon界面。

高级配置（环境变量与持久化）

自定义Java参数

通过JAVA_OPTS环境变量配置JVM参数（如内存设置）：

bash
docker run -d -p 8080:8080 \
  -e JAVA_OPTS="-Xms512m -Xmx2048m" \
  --name webspoon hiromuhota/webspoon

持久化ETL文件

通过数据卷挂载本地目录，持久化保存ETL设计文件：

bash
docker run -d -p 8080:8080 \
  -v /path/to/local/etl_files:/usr/local/tomcat/webapps/spoon/data \
  --name webspoon hiromuhota/webspoon

自定义Spoon启动选项

通过SPOON_OPTIONS环境变量设置Spoon启动参数（如禁用仓库功能）：

bash
docker run -d -p 8080:8080 \
  -e SPOON_OPTIONS="-norepo" \
  --name webspoon hiromuhota/webspoon

Docker Compose配置

创建docker-compose.yml文件实现更便捷的部署与管理：

yaml
version: '3'
services:
  webspoon:
    image: hiromuhota/webspoon
    container_name: webspoon
    ports:
      - "8080:8080"
    environment:
      - JAVA_OPTS=-Xms512m -Xmx1024m
      - SPOON_OPTIONS=-norepo
    volumes:
      - ./etl_files:/usr/local/tomcat/webapps/spoon/data
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 首次启动可能需要1-2分钟加载资源，请耐心等待
• 若主机8080端口已被占用，可修改端口映射（如-p 8888:8080）
• 生产环境建议配置资源限制（如--memory=2g --cpus=1）
• 如需使用PDI插件，可通过数据卷挂载插件目录至/usr/local/tomcat/webapps/spoon/WEB-INF/lib