Cytomine Core 容器技术文档

1. 镜像概述和主要用途

Cytomine Core 容器是基于 cytomine/tomcat7 镜像构建的核心服务组件，用于部署 Cytomine 平台的核心业务服务。作为 Cytomine 系统的中枢模块，该容器负责处理平台主要业务逻辑，包括数据交互、服务协调、用户认证及核心功能支撑。

2. 核心功能和特性

• 提供 Cytomine 平台核心业务逻辑处理能力，支撑平台基础功能运行；
• 基于 Tomcat7 运行环境，确保服务稳定性和兼容性；
• 通过环境变量配置实现灵活部署，支持与外部服务（如数据库、邮件服务）集成。

3. 使用场景和适用范围

适用于 Cytomine 生物医学图像分析平台的搭建与部署。作为系统核心组件，必须与 postgis（空间数据库）和 mongodb（文档数据库）容器协同工作，共同构成完整的 Cytomine 运行环境。

4. 配置说明

4.1 环境变量

以下环境变量用于配置容器运行参数，需根据实际部署需求设置：

4.2 端口信息

• 监听端口：8080
  容器内部通过 8080 端口提供核心服务访问，外部可通过端口映射暴露该服务。

5. 使用方法

5.1 依赖容器

部署前需确保已启动并运行以下容器，且通过 --link 参数建立链接：

• postgis：提供空间数据库支持；
• mongodb：提供文档数据库支持。

5.2 部署命令示例

使用 docker run 命令部署，需指定资源限制、环境变量及链接依赖容器。示例命令如下（替换 ${变量} 为实际值）：

docker run -m 8g -d -p 8080:8080 \
  --name core \
  --link db:db \          # 链接 postgis 容器（假设 postgis 容器名为 db）
  --link mongodb:mongodb \  # 链接 mongodb 容器（假设容器名为 mongodb）
  -e CORE_URL=${CORE_URL} \  # 核心服务 URL
  -e IMS_URLS=${IMS_URLS} \  # IMS 服务 URL 列表
  -e UPLOAD_URL=${UPLOAD_URL} \  # 上传服务 URL
  -e IMS_STORAGE_PATH=${IMS_STORAGE_PATH} \  # 主机图像存储路径
  -e IMS_BUFFER_PATH=${IMS_BUFFER_PATH} \  # 主机上传缓冲区路径
  -e ADMIN_PWD=${admin_pwd} \  # 管理员密码
  -e ADMIN_PUB_KEY=${ADMIN_PUB_KEY} \  # 管理员公钥
  -e ADMIN_PRIV_KEY=${ADMIN_PRIV_KEY} \  # 管理员私钥
  -e SUPERADMIN_PUB_KEY=${SUPERADMIN_PUB_KEY} \  # 超级管理员公钥
  -e SUPERADMIN_PRIV_KEY=${SUPERADMIN_PRIV_KEY} \  # 超级管理员私钥
  -e IMS_PUB_KEY=${IMS_PUB_KEY} \  # IMS 服务公钥
  -e IMS_PRIV_KEY=${IMS_PRIV_KEY} \  # IMS 服务私钥
  -e SENDER_EMAIL=${SENDER_EMAIL} \  # 发送者邮箱
  -e SENDER_EMAIL_PASS=${SENDER_EMAIL_PASS} \  # 发送者邮箱密码
  -e SENDER_EMAIL_SMTP_HOST=${SENDER_EMAIL_SMTP_HOST} \  # SMTP 服务器地址
  -e SENDER_EMAIL_SMTP_PORT=${SENDER_EMAIL_SMTP_PORT} \  # SMTP 服务器端口
  cytomine/core

参数说明：

• -m 8g：限制容器内存使用为 8GB；
• -d：后台运行容器；
• -p 8080:8080：将容器 8080 端口映射到主机 8080 端口（可根据需求调整主机端口）；
• --link：建立与 postgis（db）和 mongodb 容器的网络链接，确保服务间通信。