rkrahl/icat

镜像概述

本Docker镜像提供ICAT（Integrated Catalogue and Archive Toolkit）元数据目录及相关组件的预配置环境，旨在简化ICAT元数据管理系统的部署与运行流程。ICAT是一款用于科研数据管理的元数据目录工具，主要用于存储、索引和查询科研数据的元数据信息。该镜像集成了ICAT核心组件及必要依赖，提供开箱即用的运行环境，无需手动配置底层系统和组件依赖。

核心功能和特性

完整组件集成

• 包含ICAT元数据目录核心服务（如icat.server、icat.admin等）
• 内置ICAT相关依赖组件（如认证模块、数据访问接口等）
• 预配置基础数据库驱动（适配主流关系型数据库）

简化部署流程

• 预配置运行环境，无需手动安装和配置Java、数据库客户端等依赖
• 内置初始化脚本，自动完成基础配置和数据库表结构创建
• 支持容器化快速启动，从镜像拉取到服务运行全程无需复杂操作

灵活配置支持

• 通过环境变量自定义核心参数（如服务端口、数据库连接信息、认证策略等）
• 支持挂载外部配置文件覆盖默认配置，满足个性化需求
• 兼容Docker Compose等容器编排工具，支持多实例集群部署

轻量级与可维护性

• 基于精简基础镜像构建，减少资源占用
• 容器化隔离设计，避免与主机环境冲突
• 支持日志持久化和监控集成，便于系统维护

使用场景和适用范围

科研机构与学术项目

• 科研数据中心：管理实验数据、样本信息、仪器日志等科研元数据
• 学术协作项目：为跨机构合作项目提供统一的元数据索引和查询平台
• 高校实验室：用于教学实验数据的元数据跟踪和管理

数据管理与共享平台

• 数据仓库配套工具：作为数据仓库的元数据目录，提供数据资产发现能力
• 开放数据平台：为开放科学数据提供结构化元数据描述和检索功能
• 科研数据生命周期管理：跟踪数据从产生、处理到归档的全生命周期元数据

使用方法和配置说明

基本部署（单容器模式）

快速启动命令

使用默认配置启动ICAT服务（需提前准备兼容的数据库实例）：

bash
docker run -d \
  --name icat-service \
  -p 8080:8080 \  # ICAT默认HTTP服务端口
  -e DB_HOST=your-db-host \  # 数据库主机地址
  -e DB_PORT=5432 \          # 数据库端口（默认5432，适配PostgreSQL）
  -e DB_NAME=icat_db \       # ICAT数据库名称
  -e DB_USER=icat_user \     # 数据库用户名（需具备读写权限）
  -e DB_PASSWORD=your-db-password \  # 数据库密码
  icat-image:latest

参数说明

• -p 8080:8080：映射容器内ICAT服务端口到主机，主机端口可自定义（如-p 9000:8080）
• 环境变量DB_*：必填参数，用于配置数据库连接信息（ICAT支持PostgreSQL、MySQL等主流关系型数据库）

Docker Compose集成部署（含数据库）

如需快速部署包含数据库的完整环境，可使用以下docker-compose.yml配置：

yaml
version: '3.8'

services:
  icat:
    image: docker.xuanyuan.run/icat-image:latest
    container_name: icat-service
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=icat-db
      - DB_PORT=5432
      - DB_NAME=icat_db
      - DB_USER=icat_admin
      - DB_PASSWORD=secure-icat-password
      - ICAT_LOG_LEVEL=INFO  # 日志级别（可选：DEBUG/INFO/WARN/ERROR）
    depends_on:
      - icat-db  # 确保数据库先启动
    restart: unless-stopped

  icat-db:
    image: docker.xuanyuan.run/postgres:14  # ICAT推荐使用PostgreSQL 12+
    container_name: icat-db
    environment:
      - POSTGRES_DB=icat_db
      - POSTGRES_USER=icat_admin
      - POSTGRES_PASSWORD=secure-icat-password
    volumes:
      - icat-db-data:/var/lib/postgresql/data  # 持久化数据库数据
    ports:
      - "5432:5432"  # 可选：暴露数据库端口供外部管理
    restart: unless-stopped

volumes:
  icat-db-data:  # 定义数据库数据卷

启动命令：

bash
docker-compose up -d

自定义配置与扩展

挂载外部配置文件

如需自定义ICAT核心配置（如认证策略、数据模型等），可挂载外部配置文件覆盖容器内默认配置：

bash
docker run -d \
  --name icat-service \
  -p 8080:8080 \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_NAME=icat_db \
  -e DB_USER=icat_user \
  -e DB_PASSWORD=your-db-password \
  -v /local/path/to/icat-config:/etc/icat/conf \  # 挂载外部配置目录
  icat-image:latest

日志持久化

通过挂载日志目录实现日志持久化：

bash
docker run -d \
  --name icat-service \
  -p 8080:8080 \
  -e DB_HOST=your-db-host \
  -v /local/path/to/icat-logs:/var/log/icat \  # 挂载日志目录
  icat-image:latest

验证服务可用性

服务启动后，可通过以下方式验证ICAT是否正常运行：

1. 访问ICAT管理界面：http://<主机IP>:8080/icat/admin（默认管理员账户需参考ICAT官方文档初始化）
2. 检查容器日志：docker logs icat-service，确认无错误日志输出
3. 访问健康检查接口：http://<主机IP>:8080/icat/health，返回UP状态表示服务正常