hlnconsulting/ice

ICE Docker镜像技术文档

1. 镜像概述和主要用途

ICE（Immunization Calculation Engine，免疫计算引擎）是一款用于免疫计算的服务型应用。本Docker镜像（hlnconsulting/ice）提供了ICE服务的便捷部署方式，用户可通过容器化技术快速搭建和运行ICE服务，无需复杂的环境配置。

2. 核心功能和特性

• 免疫计算服务：提供核心免疫计算功能，支持疫苗接种计划评估等场景。
• 容器化部署：基于Docker封装，简化安装流程，确保环境一致性。
• 灵活配置：支持通过环境变量自定义时区、日志参数等关键配置。
• 日志管理：支持设置日志文件大小和数量限制，避免日志过度占用存储空间。
• REST接口：提供RESTful API，可通过测试脚本验证服务可用性。

3. 使用场景和适用范围

适用于需要集成免疫计算功能的***机构、健康信息系统开发者，以及相关科研机构。通过Docker镜像可快速部署ICE服务，满足免疫接种计划评估、疫苗接种建议生成等业务需求。

4. 安装与部署

4.1 拉取镜像

从Docker Hub拉取最新版ICE镜像：

bash
docker pull hlnconsulting/ice:latest

4.2 运行容器

4.2.1 基础部署

启动ICE服务，映射主机端口32775至容器内8080端口，并配置日志参数：

bash
docker run \
  --log-opt max-size=100m \
  --log-opt max-file=5 \
  --rm -d \
  -p 32775:8080 \
  --name ice \
  hlnconsulting/ice:latest

4.2.2 自定义时区

如需修改服务时区，可通过TZ环境变量指定（例如America/New_York）：

bash
docker run \
  -e TZ=America/New_York \
  --log-opt max-size=100m \
  --log-opt max-file=5 \
  --rm -d \
  -p 32775:8080 \
  --name ice \
  hlnconsulting/ice:latest

4.3 服务测试

服务启动后，可通过以下脚本验证功能：
https://github.com/cdsframework/ice/tree/master/curl-rest-tests

5. 日志管理

查看实时运行日志：

bash
docker logs -f ice

6. 服务管理

6.1 关闭服务

执行容器内Tomcat的关闭脚本：

bash
docker exec -it ice /usr/local/tomcat/bin/shutdown.sh

7. 配置说明

7.1 环境变量

ICE服务支持通过以下环境变量自定义配置，默认值及说明如下：

8. 相关资源与支持

8.1 官方文档

• ICE Wiki
• ICE客户端实现指南
• ICE安装指南
• 源码构建指南

8.2 社区与支持

• 邮件列表：订阅ICE公告邮件列表获取更新
• 技术支持：发送问题至ice@hln.com
• 商业支持：访问HLN Consulting ICE服务

8.3 最新动态

• ICE新闻页面