datacube-wps 技术文档

1. 镜像概述

1.1 简介

datacube-wps 是一个基于 PYWPS ([***] 4.2.4 版本开发的 Web 处理服务，遵循 Apache Software License 2.0 开源许可协议。

1.2 主要用途

提供地理空间数据处理能力，允许用户通过 Web 服务接口执行特定的数据处理流程。

2. 核心功能与特性

• 基于 PYWPS 4.2.4 构建，兼容 WPS 标准
• 内置数据处理流程：
  • FCDrill
  • WOfSDrill
• 可通过配置文件自定义可用处理流程
• 支持 Flask 开发服务器和 Gunicorn 生产部署

3. 使用场景与适用范围

适用于需要通过 Web 服务接口提供地理空间数据处理能力的场景，特别是与 Open Data Cube 生态系统集成的数据处理服务。支持开发环境快速测试和生产环境稳定部署。

4. 配置说明

4.1 配置文件

核心配置文件为 pywps.cfg，主要配置项说明：

4.2 流程配置

可用处理流程通过 DEA_WPS_config.yaml 文件定义，可通过修改此文件添加或移除可用流程。

5. 使用方法

5.1 使用 Flask 开发服务器

5.1.1 配置

修改 pywps.cfg 文件：

url=http://localhost:5000
workdir=tmp
outputurl=http://localhost:5000/outputs/
outputpath=outputs
base_route=/

5.1.2 启动服务

bash
export FLASK_APP=wps.py
flask run

5.2 使用 Gunicorn 部署

5.2.1 注意事项

• 默认配置下仅支持单实例部署
• 多实例部署需确保所有实例共享同一个输出文件夹

5.2.2 配置

修改 pywps.cfg 文件，设置服务 URL：

url=[***]
outputurl=[***]

5.2.3 启动服务

bash
gunicorn -b 0.0.0.0:8000 wps:app

5.3 自定义处理流程

编辑 DEA_WPS_config.yaml 文件，添加或移除流程定义，以控制对用户可用的处理流程。

6. 测试与调试

6.1 工作流测试（从 Terria 到 WPS 服务）

1. 生成测试用 Terria 目录：

   • 访问 [***]
   • 输入 WPS 服务 URL 或使用默认值
   • 点击 "Create Catalog" 按钮
   • 验证 JSON 格式的服务列表是否正确
   • 可修改文件名或使用默认值
   • 点击 "download catalog" 按钮下载生成的目录文件

2. 在 Terria 中测试：

   • 访问 [***]
   • 点击 "Add data"
   • 选择 "my data" 标签
   • 点击 "Add local data" 并选择下载的目录文件

6.2 单个服务调试测试

6.2.1 获取请求 payload

1. 打开浏览器开发者工具，切换到 "network" 标签
2. 在 "Data Catalogue" 中添加需要测试的 WPS 服务
3. 填写 Terria 表单并点击 "Run Analysis" 按钮
4. 等待网络请求完成
5. 找到名称为 ?service=WPS&request=Execute 的请求，打开 "Headers" 标签
6. 记录以下信息用于 API 测试：
   • "Request Payload" 中的 XML 内容
   • "General" 下的 "Request URL"

6.2.2 使用 Web API 工具测试

1. 访问 [***]
2. 设置 URL 为步骤 6.2.1 中获取的 "Request URL"
3. 设置请求体为步骤 6.2.1 中获取的 XML 内容
4. 发送请求并验证响应结果