sogis/modelfinder

modelfinder Docker镜像文档

概述

modelfinder是一个专注于地理空间数据模型管理的工具，旨在简化地理空间模型的查找、检索和管理流程。该Docker镜像封装了modelfinder的核心功能，提供便捷的部署方式，可快速集成到各类GIS（地理信息系统）工作流中，支持多种地理空间模型格式，帮助用户高效管理地理空间数据模型资源。

核心功能与特性

• 多格式支持：兼容常见的地理空间数据模型格式，如GeoJSON、Shapefile、GML等。
• 高效检索：提供基于元数据、属性和空间范围的模型检索能力，支持关键词搜索和过滤。
• API接口：内置RESTful API，方便与其他GIS工具或应用程序集成，支持模型的查询、获取和管理操作。
• 轻量级部署：通过Docker容器化部署，简化环境配置，降低依赖管理复杂度。
• 可扩展性：支持自定义模型元数据字段，适应不同场景下的模型管理需求。

使用场景与适用范围

• GIS工作流集成：作为地理空间数据模型管理组件，集成到GIS数据处理、分析或可视化工作流中。
• 模型库管理：用于搭建企业或组织内部的地理空间模型库，统一管理分散的模型资源。
• 开发与测试：为GIS应用开发提供模型检索和管理服务，加速应用开发进程。
• 数据共享平台：作为地理空间模型共享平台的后端服务，提供模型查询和获取能力。

使用方法

基本部署

通过以下命令拉取并运行modelfinder Docker镜像：

bash
docker run -d -p 8080:8080 --name modelfinder docker.xuanyuan.run/sogis/modelfinder:latest

• -p 8080:8080：将容器内8080端口映射到主机8080端口，用于访问API服务。
• --name modelfinder：指定容器名称为modelfinder。

集成到Docker Compose

在docker-compose.yml中添加以下配置：

yaml
version: '3'
services:
  modelfinder:
    image: docker.xuanyuan.run/sogis/modelfinder:latest
    ports:
      - "8080:8080"
    environment:
      - MODEL_STORAGE_PATH=/models
      - LOG_LEVEL=INFO
    volumes:
      - ./models:/models  # 挂载本地模型存储目录

配置参数

环境变量

数据持久化

通过挂载卷（volume）将模型文件存储目录映射到本地，确保容器重启后模型数据不丢失，如上述Docker Compose示例中的./models:/models配置。

API使用示例

服务启动后，可通过以下API端点进行操作：

• 获取所有模型列表：GET http://localhost:8080/api/models
• 搜索模型：GET http://localhost:8080/api/models/search?keyword=building
• 获取模型详情：GET http://localhost:8080/api/models/{modelId}

具体API文档可访问http://localhost:8080/swagger-ui.html查看（需容器支持Swagger文档）。

注意事项

• 确保挂载的模型存储目录具有适当的读写权限，避免容器访问文件时出现权限错误。
• 根据实际需求调整日志级别，生产环境建议使用WARN或ERROR以减少日志量。
• 如需要自定义模型元数据字段，可通过修改配置文件（需参考GitHub仓库文档获取具体配置方法）实现。

更多信息

完整文档和源码请参考：https://github.com/sogis/modelfinder