maduhu/webspoon

webspoon Docker镜像文档

镜像概述和主要用途

webspoon Docker镜像是Pentaho Data Integration (Kettle)的Web版实现（webSpoon）的容器化部署方案，用于数据集成、ETL（抽取、转换、加载）流程的设计与管理。通过Docker容器化，可快速部署webSpoon服务，支持灵活配置和数据持久化。

核心功能和特性

• 支持多版本标签，满足不同部署需求（如最新提交、最新发布、特定版本）
• 可自定义Java堆大小，适应不同服务器内存配置
• 支持用户配置和数据持久化，通过卷挂载共享.kettle和.pentaho目录
• 允许运行时配置web.xml和security.xml，实现用户认证等功能
• 集成自定义安全管理器，支持文件访问控制（实验性）
• 提供调试模式，支持远程调试和开发模式

标签说明

使用方法和配置说明

构建镜像

bash
$ docker build --no-cache -t hiromuhota/webspoon:latest .

基础用法

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

服务启动后，访问 http://ip地址:8080/spoon/spoon 即可使用webSpoon。

高级用法

Java堆大小配置

默认Java堆大小为 -Xms1024m -Xmx2048m，可通过JAVA_OPTS环境变量覆盖。例如，服务器内存为2GB时，可调整为：

bash
$ docker run -d -p 8080:8080 \
-e JAVA_OPTS="-Xms1024m -Xmx1920m" \
hiromuhota/webspoon

用户配置和数据持久化/共享

若需在容器间共享配置文件，可挂载.kettle和.pentaho目录：

bash
$ docker run -d -p 8080:8080 \
-v kettle:/home/tomcat/.kettle -v pentaho:/home/tomcat/.pentaho \
hiromuhota/webspoon

或使用docker-compose：

bash
$ docker-compose up -d

webSpoon配置

从0.8.0.14版本开始，spoon.war已预提取至$CATALINA_HOME/webapps/spoon，可通过绑定挂载在运行时配置web.xml等文件。例如，启用用户认证：

1. 下载https://github.com/HiromuHota/pentaho-kettle/blob/webspoon-8.2/assemblies/static/src/main/resources-filtered/WEB-INF/web.xml%E5%B9%B6%E6%8C%89https://github.com/HiromuHota/pentaho-kettle#user-authentication%E7%BC%96%E8%BE%91
2. 挂载配置文件：

bash
$ docker run -d -p 8080:8080 \
-v $(pwd)/web.xml:/usr/local/tomcat/webapps/spoon/WEB-INF/web.xml \
hiromuhota/webspoon

类似地，可配置$CATALINA_HOME/webapps/spoon/WEB-INF/spring/security.xml。

安全管理器

要启用https://github.com/HiromuHota/pentaho-kettle/wiki/Admin%3A-Security#file-access-control-by-a-custom-security-manager-experimental%EF%BC%8C%E9%9C%80%E5%85%88%E5%90%AF%E7%94%A8https://github.com/HiromuHota/pentaho-kettle/wiki/Admin%3A-Security#user-authentication%EF%BC%8C%E5%B9%B6%E6%B7%BB%E5%8A%A0%60CATALINA_OPTS%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%9A

bash
$ docker run -d -p 8080:8080 \
-e CATALINA_OPTS="-Djava.security.manager=org.pentaho.di.security.WebSpoonSecurityManager -Djava.security.policy=/usr/local/tomcat/conf/catalina.policy" \
-v $(pwd)/web.xml:/usr/local/tomcat/webapps/spoon/WEB-INF/web.xml \
-v $(pwd)/catalina.policy:/usr/local/tomcat/conf/catalina.policy \
hiromuhota/webspoon

调试模式

bash
$ docker run -d -p 8080:8080 -p 8000:8000 \
-e JPDA_ADDRESS=8000 \
-e CATALINA_OPTS="-Dorg.eclipse.rap.rwt.developmentMode=true" \
hiromuhota/webspoon catalina.sh jpda run