scieloorg/opac_proc

opac_proc## 镜像概述和主要用途

opac_proc是一个数据处理程序，用于从Article Meta收集数据并将其存储到MongoDB中，以便通过OPAC系统展示。该镜像提供了便捷的部署方式，可通过环境变量配置关键参数，适用于需要为OPAC系统准备和维护数据的场景。

核心功能和特性

• 数据收集：从Article Meta的Thrift API获取数据
• 数据存储：将处理后的数据存储到MongoDB数据库
• 日志管理：生成详细日志并支持日志级别配置
• 灵活配置：通过环境变量自定义数据库连接、处理集合、日志等参数
• 容器化部署：支持Docker和docker-compose部署，易于集成到现有系统

使用场景和适用范围

适用于需要为OPAC（在线公共访问目录）系统提供数据支持的场景，特别是需要从Article Meta获取并处理学术文献元数据的机构或项目。

前置要求

• Docker环境
• 具有写入权限的MongoDB实例访问权限
• 用于写入日志的文件系统访问权限

镜像获取

拉取镜像

如需直接使用预构建镜像：

bash
docker pull scieloorg/opac_proc

本地构建镜像

如需本地构建镜像：

bash
docker build -t opac_proc .

使用方法

基本运行示例

以下示例处理缩写为spa的集合，将容器的/app/logs目录挂载到本地/tmp/opac_proc_logs/，并配置MongoDB连接参数：

bash
docker run -v /tmp/opac_proc_logs/:/app/logs/ \
    -e OPAC_PROC_COLLECTION="spa" \
    -e OPAC_PROC_MONGODB_HOST="localhost" \
    -e OPAC_PROC_MONGODB_PORT="27017" \
    -e OPAC_PROC_MONGODB_NAME="opac_test" \
    -e OPAC_PROC_LOG_LEVEL="DEBUG" \
    opac_proc

环境变量配置

容器支持以下环境变量配置：

• OPAC_PROC_LOG_LEVEL：日志级别（可选值：["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"]，默认："INFO"）
• OPAC_PROC_LOG_FILE_PATH：日志文件绝对路径（默认："<容器卷>/app/log/<当前日期>.log"）
• OPAC_PROC_ARTICLE_META_THRIFT_DOMAIN：Article Meta的Thrift API域名（默认："articlemeta.scielo.org"）
• OPAC_PROC_ARTICLE_META_THRIFT_PORT：Article Meta的Thrift API端口（默认："***"）
• OPAC_PROC_COLLECTION：要处理的集合缩写（默认："spa"）
• OPAC_PROC_MONGODB_NAME：MongoDB数据库名称（默认："opac"）
• OPAC_PROC_MONGODB_HOST：MongoDB主机/IP（默认："localhost"）
• OPAC_PROC_MONGODB_PORT：MongoDB端口（默认：27017）
• OPAC_PROC_MONGODB_USER：[可选]MongoDB访问用户
• OPAC_PROC_MONGODB_PASS：[可选]MongoDB用户密码

日志管理

日志文件存储在容器的/app/logs/目录，文件名为当前日期（格式：YYYY-MM-DD.log）。建议通过卷挂载将此目录映射到本地，以便持久化日志。

使用docker-compose部署

1. 编辑docker-compose.yml文件，配置所需参数
2. 执行以下命令启动服务：

bash
docker-compose up

注意：默认情况下，docker-compose会拉取scieloorg/opac_proc镜像。如需使用本地构建的镜像，请将配置文件中的image: scieloorg/opac_proc替换为build: .。

徽章

![Code Health]([] ![Build Status]([] ![Updates]([] ![Python 3]([]