dbsmith88/hms_dotnetcore

HMS镜像说明

镜像概述

Hydrologic Micro Services（HMS）是一组水文微服务集合，用于检索水文数据和执行模型，可通过REST API访问。该镜像基于.NET Core 2开发，支持Docker部署，集成Swagger接口文档以简化使用。

核心功能

• 检索水文数据
• 执行水文模型
• 通过REST API提供标准化服务访问
• 自动生成Swagger接口文档（基于Swashbuckle实现）

使用场景

• 水文数据查询与分析场景
• 水文模型运行与结果获取
• 水文相关应用的微服务集成
• 开发环境中快速部署水文服务原型

配置说明

开发设置

获取或fork源码：https://github.com/quanted/hms.git%EF%BC%8C%E4%BB%8EWeb.Services%E9%A1%B9%E7%9B%AE%E5%90%AF%E5%8A%A8%E5%BA%94%E7%94%A8%EF%BC%8C%E6%94%AF%E6%8C%81%E4%B8%89%E7%A7%8D%E8%BF%90%E8%A1%8C%E6%96%B9%E5%BC%8F%EF%BC%9A

1. IIS：生成发布包后导入IIS作为.NET Core 2 Web应用运行
2. Docker：使用Web.Services目录下的Dockerfile构建镜像（基于dotnet:2.1-sdk，含单元测试依赖）
3. docker-compose：通过项目根目录的docker-compose.yml实现多容器部署，可参考quanted/qed的配置示例

访问端点

所有接口通过Swagger文档化，本地部署后访问地址为http://localhost:PORT/swagger（PORT可通过docker ps查看容器映射端口）

Docker部署示例

构建镜像

bash
# 进入Web.Services目录
cd Web.Services
# 构建镜像
docker build -t dbsmith88/hms_dotnetcore .

运行容器

bash
docker run -d -p 8080:80 dbsmith88/hms_dotnetcore

运行后通过http://localhost:8080/swagger访问接口文档

架构与流程参考

• 数据请求流程图：!https://github.com/quanted/hms/blob/dev/hms_stack%20_flow_diagram.png
• 架构图：!https://github.com/quanted/hms/blob/dev/hms_architecture_diagram_docker.png