hbpmip/portal-backend

hbpmip/portal-backend

镜像概述和主要用途

这是MIP（医学影像平台）门户后端的Docker镜像，用于提供MIP门户的后端服务支持。使用此镜像需确保已运行PostgreSQL实例，并通过环境变量进行必要配置。

核心功能和特性

• 支持连接多个数据库（门户数据库、元数据库、科学数据库）
• 集成OAuth2认证机制，支持HBP OpenID服务器登录
• 与前端门户交互，处理登录/登出重定向逻辑
• 可配置日志级别，支持Web层和Hibernate层日志控制
• 连接外部服务（如WOKEN机器学习服务器、EXAREME服务器）
• 支持嵌入式服务器配置（上下文路径、会话超时）

使用场景和适用范围

适用于部署MIP门户后端服务的环境，需配合PostgreSQL数据库、前端门户及相关外部服务（如WOKEN、EXAREME）使用，适用于医学影像平台相关的后端服务搭建。

详细使用方法和配置说明

前提条件

• 已运行的PostgreSQL实例
• 必要的环境变量配置（尤其是数据库密码、OAuth2客户端信息等）

环境变量配置

数据库配置（DATABASES）

• PORTAL_DB_URL：门户数据库连接的JDBC URL，默认值为"jdbc:postgresql://172.22.0.1:5432/portal"

• PORTAL_DB_SCHEMA：数据库模式，默认值为"public"

• PORTAL_DB_USER：连接门户数据库的用户，默认值为"postgres"

• PORTAL_DB_PASSWORD：连接门户数据库的密码（必填）

• META_DB_URL：元数据库连接的JDBC URL，默认值为"jdbc:postgresql://172.22.0.1:5432/meta"

• META_DB_SCHEMA：元数据库模式，默认值为"public"

• META_DB_USER：连接元数据库的用户（必填）

• META_DB_PASSWORD：连接元数据库的密码（必填）

• FEATURES_DB_URL：科学数据库连接的JDBC URL，默认值为"jdbc:postgresql://172.22.0.1:5433/features"

• FEATURES_DB_SCHEMA：科学数据库模式，默认值为"public"

• FEATURES_DB_USER：连接科学数据库的用户，默认值为"postgres"

• FEATURES_DB_PASSWORD：连接科学数据库的密码（必填）

• FEATURES_DB_MAIN_TABLE：包含科学数据的表名，默认值为"features"

OAuth2登录配置（OAUTH2 LOGIN）

• AUTHENTICATION：是否启用认证，"0"为禁用，"1"为启用，默认值为"1"
• CLIENT_ID：启用认证时必填，HBP OpenID服务器的客户端ID（参考HBP OpenID服务器）
• CLIENT_SECRET：启用认证时必填，HBP OpenID服务器的客户端密钥（参考HBP OpenID服务器）
• TOKEN_URI：令牌URI，默认值为"https://services.humanbrainproject.eu/oidc/token"
• AUTH_URI：授权URI，默认值为"https://services.humanbrainproject.eu/oidc/authorize"
• USER_INFO_URI：用户信息URI，默认值为"https://services.humanbrainproject.eu/oidc/userinfo"
• REVOKE_TOKEN_URI：令牌撤销URI，默认值为"https://services.humanbrainproject.eu/oidc/slo"

Web前端配置（WEB FRONTEND）

• FRONTEND_LOGIN_URL：需要登录时重定向的URL，默认值为"http://frontend/services/login/hbp"
• FRONTEND_AFTER_LOGIN_URL：登录后重定向的URL，默认值为"http://frontend/home"
• FRONTEND_AFTER_LOGOUT_URL：登出后重定向的URL，默认值为"http://frontend/services/login/hbp"

日志配置（LOGGING）

• LOGGING_LEVEL_WEB：应用Web层的日志级别，默认值为"WARN"
• LOGGING_LEVEL_HIBERNATE：应用Hibernate层的日志级别，默认值为"WARN"

外部服务端点配置（ENDPOINTS）

• WOKEN_URL：WOKEN机器学习服务器的URL，默认值为"http://172.22.0.1:8087"

• WOKEN_HOST：WOKEN主机名，默认值为"woken"

• WOKEN_AKKA_PORT：WOKEN Akka端口，默认值为"8088"

• WOKEN_AKKA_PATH：WOKEN Akka路径，默认值为"/user/entrypoint"

• EXAREME_URL：Exareme服务器的URL，默认值为"http://hbps2.chuv.ch:9090"

嵌入式服务器配置（EMBEDDED SERVER CONFIGURATION）

• CONTEXT_PATH：容器中所有服务的上下文路径，默认值为"/services"
• SESSION_TIMEOUT：会话过期超时时间（毫秒），默认值为2592000

Docker部署示例

使用docker run运行

bash
docker run -d \
  --name portal-backend \
  -e PORTAL_DB_PASSWORD=your_portal_db_password \
  -e META_DB_USER=your_meta_db_user \
  -e META_DB_PASSWORD=your_meta_db_password \
  -e FEATURES_DB_PASSWORD=your_features_db_password \
  -e CLIENT_ID=your_hbp_client_id \
  -e CLIENT_SECRET=your_hbp_client_secret \
  hbpmip/portal-backend

说明

• 上述命令中，PORTAL_DB_PASSWORD、META_DB_USER、META_DB_PASSWORD、FEATURES_DB_PASSWORD、CLIENT_ID、CLIENT_SECRET为必填环境变量，需根据实际环境替换
• 其他环境变量如使用默认值可省略，如需自定义可添加-e 变量名=值参数