wetransform/etf-webapp

etf-WebApp Docker镜像

![European Union Public Licence 1.2]([***]

镜像概述

本镜像为ETF（开源地理网络服务与数据测试框架）的web应用Docker镜像，基于官方Jetty镜像构建，主要用于测试场景，容器会加载最新开发版本的ETF。

核心功能

• 提供开源地理网络服务与数据的测试能力
• 支持数据持久化（通过挂载卷保存配置、测试数据等）
• 可通过docker-compose配置Nginx代理实现访问保护
• 支持组织内部代理服务器配置
• 自动下载INSPIRE可执行测试套件
• 支持自定义测试套件部署

使用场景

• 地理信息系统（GIS）相关服务的功能测试
• 地理数据的合规性验证
• 开发环境中ETF框架的快速试用与验证
• 组织内部地理服务的自动化测试

配置说明

前提条件

• 已安装并配置Docker引擎（参考Docker安装文档），镜像已在Linux机器上测试通过
• 推荐安装docker-compose（参考docker-compose安装文档），便于配置HTTP代理和更新

快速启动

运行以下命令在8080端口启动容器，并在用户主目录创建etf数据目录：

bash
docker run --name etf -d -p 80:8080 -v ~/etf:/etf iide/etf-webapp:latest

若需修改主机数据目录，可调整-v参数前半部分（如-v /home/user1/my_etf:/etf）。启动后通过docker ps查看容器状态，访问http://localhost/etf-webapp即可进入web界面（启动可能需要一点时间）。

基于docker-compose的设置

1. 确保docker-compose版本≥1.8：

bash
docker-compose -v

2. 创建etfenv目录并下载配置文件：

bash
mkdir etfenv && cd etfenv && \
wget https://raw.githubusercontent.com/etf-validator/etf-webapp-docker/master/etfenv/docker-compose.yml && \
wget https://raw.githubusercontent.com/etf-validator/etf-webapp-docker/master/etfenv/htpasswd.txt && \
wget https://raw.githubusercontent.com/etf-validator/etf-webapp-docker/master/etfenv/nginx.conf

3. 启动容器：

bash
docker-compose up -d

首次启动会下载最新ETF版本及INSPIRE测试套件，可通过docker-compose logs -f查看进度。访问http://localhost并使用默认凭据（etf/etf）登录，若需外部访问，修改/etf/config/etf-config.properties中的etf.webapp.base.url为IP或域名后重启容器：

bash
docker-compose restart

代理服务器配置

若组织内部有代理过滤网络流量，可在docker-compose.yml中添加代理设置（如HTTP_PROXY_HOST、HTTP_PROXY_PORT等）。

更新ETF

在etfenv目录执行以下命令更新容器：

bash
docker-compose stop && docker-compose rm && docker-compose pull && docker-compose up -d

测试套件更新与自定义

• 更新测试套件：将新套件复制到/etf/projects/目录，实例会自动 reload
• 自定义测试套件：修改docker-compose.yml中的ETF_TESTPROJECTS_ZIP环境变量为自定义URL，容器启动时会自动下载部署

日志文件

日志文件etf.log位于/etf/logs目录。