ZOO-Project Docker镜像文档

1. 镜像概述和主要用途

ZOO-Project是一个开源处理平台，基于MIT/X11许可证发布，专注于实现开放地理空间联盟（OGC）标准。该平台提供多语言处理内核、即用型服务集合、跨语言调用接口及客户端交互工具，核心用途是作为Web处理服务（WPS 1.0.0/2.0.0）和OGC API - Processes标准的服务器实现，支持地理空间数据处理、多语言服务集成及标准化数据发布。

2. 核心功能和特性

2.1 ZOO-Kernel

强大的处理引擎，支持多语言服务执行和GIS工具集成：

• 多语言支持：可执行C/C++、C#、Fortran、Java、JavaScript、Python、PHP、Perl、Ruby、R、Node.js等语言实现的服务
• GIS引擎集成：支持Orfeo ToolBox、SAGA-GIS等GIS处理引擎的现有应用
• 数据自动发布：将服务执行结果自动发布至MapServer，通过WMS、WFS、WCS标准对外提供数据访问

2.2 ZOO-Services

包含服务元数据和可执行实现，便于快速构建和集成服务：

• 元数据管理：支持ZCFG格式、YAML或数据库存储，定义服务输入输出、类型、数量等属性
• 多形式实现：ServiceProvider根据语言不同呈现为共享库（C/C++）、脚本文件（JavaScript/Python）等形式
• 现有工具集成：已集成GDAL工具（ogr2ogr、gdal_wrap等）和CGAL计算几何算法库，简化现有代码的服务化过程

2.3 ZOO-API

跨语言服务调用接口，允许服务间相互调用：

• 最初仅支持JavaScript，现扩展至所有支持语言
• 暴露ZOO-Kernel变量和函数，实现不同语言或GIS引擎服务的嵌套调用

2.4 ZOO-Client

JavaScript客户端API，用于构建与WPS服务器交互的客户端应用。

3. 使用场景和适用范围

• GIS开发者：需实现自定义地理空间处理服务的开发人员
• 多语言服务集成：需统一管理不同编程语言（C/C++、Python、Java等）实现的处理逻辑
• OGC标准服务部署：需快速搭建符合WPS、OGC API - Processes、WMS/WFS/WCS标准的服务
• GIS工具Web化：需将Orfeo ToolBox、SAGA-GIS等桌面GIS工具功能转化为Web服务
• 地理数据自动化处理：需批量处理地理数据并通过标准协议发布结果

4. 使用方法和配置说明

4.1 Docker部署

4.1.1 环境要求

• Docker 19.03+及Docker Compose 1.25+
• 至少2GB内存（GIS处理需较高资源）
• 网络连接（用于拉取镜像和依赖）

4.1.2 快速启动流程

# 克隆代码仓库
git clone [***]
cd ZOO-Project

# 创建临时目录并设置权限
mkdir -p docker/tmp && chmod -R 777 docker

# 启动服务
docker-compose up

服务启动后，通过浏览器访问 http://localhost，即可使用700+内置ZOO-Services，支持WPS和OGC API - Processes接口。

4.1.3 容器访问与管理

• 停止服务：docker-compose down
• 后台运行：docker-compose up -d
• 查看日志：docker-compose logs -f

4.2 配置自定义

4.2.1 服务元数据配置

元数据定义服务的输入输出规范，支持以下配置方式：

1. ZCFG文件
   在项目services目录下创建.zcfg文件，示例格式：

   [ServiceMetadata]
   Name=SampleService
   Title=Sample Geospatial Service
   Abstract=A sample service for demonstration
   
   [Input]
   Name=InputData
   Title=Input Geospatial Data
   Type=ComplexData
   MinOccurs=1
   MaxOccurs=1
   
   [Output]
   Name=OutputResult
   Title=Processed Result
   Type=ComplexData
   

2. YAML格式
   创建.yaml文件定义元数据，需在docker-compose.yml中添加环境变量ZOO_METADATA_FORMAT=yaml指定格式。

3. 数据库存储
   修改docker-compose.yml添加数据库服务（如PostgreSQL），并配置连接参数：

   environment:
     - DB_HOST=db
     - DB_USER=zoo
     - DB_PASS=zoo_pass
     - DB_NAME=zoo_metadata
   

4.2.2 自定义服务集成

添加自定义服务步骤：

1. 编写服务实现代码（如Python脚本my_service.py）
2. 创建元数据文件（如my_service.zcfg）
3. 将文件放置于宿主机./docker/services目录（自动映射至容器内/zoo-services）
4. 重启服务：docker-compose restart

4.3 性能优化

• 资源分配：在docker-compose.yml中调整服务资源限制：

  services:
    zoo-kernel:
      deploy:
        resources:
          limits:
            cpus: '4'
            memory: 8G
  

• 缓存配置：启用MapServer缓存加速WMS/WFS/WCS请求，修改mapserver.conf启用缓存目录。

5. 许可证信息

ZOO-Project Docker镜像基于MIT/X11许可证发布。