infrascielo/opac Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
infrascielo/opac自动构建
infrascielo
SciELO在线公共访问目录(OPAC)的Docker镜像，支持开发和生产环境部署，提供学术资源访问功能，可通过环境变量和配置文件自定义，包含多种Docker配置文件及测试脚本。
1 次收藏下载次数: 0状态：自动构建维护者：infrascielo仓库类型：镜像最近更新：1 年前
SciELO - 在线公共访问目录 (OPAC) Docker镜像
镜像概述和主要用途
本镜像为SciELO在线公共访问目录(OPAC)的Docker化部署方案，用于提供学术资源的在线查询与访问服务。支持开发环境和生产环境部署，可通过配置文件或环境变量自定义系统参数，包含完整的容器化配置及测试脚本，便于快速搭建和维护OPAC系统。
核心功能和特性
- 多环境支持：提供开发环境（Dockerfile-dev）和生产环境（Dockerfile）的镜像构建配置
- 灵活配置：通过环境变量或配置文件自定义系统参数，如旧网站链接、提示消息、数据库连接等
- 完整容器化：包含多个docker-compose配置文件，支持生产、CI/Travis及开发环境的容器编排
- 测试支持：提供单元测试（
make test）和覆盖率报告（make test_coverage）脚本 - 数据导入：支持通过Fixtures导入开发环境测试数据，快速搭建演示环境
使用场景和适用范围
适用于学术机构、图书馆等需要部署SciELO OPAC系统的场景，可用于：
- 开发团队搭建本地开发环境
- 生产环境部署公共访问的OPAC系统
- CI/CD流程中自动化构建和测试
详细的使用方法和配置说明
安装与配置
GitHub Wiki提供了不同环境的安装配置指南：
- 开发环境
- 生产环境（CentOS，Gunicorn/Nginx/Supervisor）
- 生产环境（CentOS，Chaussette/Nginx/Circus）
网站配置指南
完整配置指南及通过配置文件或环境变量调整参数的方法，可参考Wiki文档。
常用自定义配置示例：
- 在网站首页显示旧版网站链接：
PREVIOUS_WEBSITE_URI=[***] - 在网站首页显示多语言提示消息：
ALERT_MSG_PT=Novo portal pode conter incorreções ALERT_MSG_EN=New portal may contain inaccuracies ALERT_MSG_ES=Nuevo portal puede contener incorrecciones
Docker相关文件说明
| 文件 | 说明 |
|---|---|
| Dockerfile | 生产环境镜像构建定义 |
| Dockerfile-dev | 开发环境镜像构建定义 |
| docker-compose.yml | 生产环境容器编排配置 |
| docker-compose-build.yml | Travis/CI环境构建与容器编排配置 |
| docker-compose-dev.yml | 开发环境容器编排配置 |
测试执行方法
- 运行单元测试：
make test - 生成覆盖率报告：
make test_coverage
开发环境Docker安装步骤
通过项目根目录的Dockerfile-dev和docker-compose-dev.yml配置，快速搭建开发环境：
- 构建OPAC镜像：
make dev_compose_build - 启动容器：
make dev_compose_up - 访问应用：浏览器打开
http://localhost（macOS用户需使用docker-machine ip获取的IP） - 查看日志：
make dev_compose_logs - 停止容器：
make dev_compose_stop - 进入容器终端：
make dev_compose_exec_shell_webapp
Fixtures数据导入（开发环境）
通过SciELO提供的fixtures文件填充测试数据：
- 确保开发环境已启动：
make dev_compose_up - 下载fixtures文件（轻量版含4种期刊）：
wget [***]
或完整版：wget [***] - 解压文件：
unzip opac_br.zip（生成含.bson、.json、.sqlite及media目录的opac_br文件夹） - 进入目录：
cd opac_br - 恢复MongoDB数据：
mongorestore --host=localhost --port=27017 -d=opac --dir . - 复制media目录到项目根目录的data目录（默认映射到OPAC应用）
- 复制opac.sqlite到项目根目录的data目录
- 配置
docker-compose-dev.yml参数：yamlenvironment: - OPAC_SSM_DOMAIN=minio.scielo.br - OPAC_SSM_PORT=443 - OPAC_SSM_SCHEME=https - OPAC_SSM_XML_URL_REWRITE=False - 重启容器：
make dev_compose_stop && make dev_compose_up
注意：需安装MongoDB数据库工具获取
mongorestore；访问文章页面需连接SciELO ***；管理员账号：***，密码：admin。
环境变量配置
| 变量名 | 默认值 | 可能值 | 最后评估日期 | 说明 |
|---|---|---|---|---|
| OPAC_USE_HOME_METRICS | False | True/False | 2021-11-21 | 启用/禁用首页馆藏指标数据显示（默认禁用） |
| OPAC_DEBUG_MODE | False | True/False | 2021-11-21 | 启用/禁用调试模式（生产环境需禁用） |
| OPAC_SECRET_KEY | secr3t-k3y | 随机字符串 | 2021-11-21 | 应用表单安全随机密钥 |
| OPAC_COLLECTION | scl | scl, spa, mex等 | 2021-11-21 | OPAC馆藏缩写标识 |
| OPAC_DEFAULT_EMAIL | *** | ***地址 | 2021-11-21 | 系统发件***账号 |
| OPAC_MONGODB_HOST | localhost | 主机地址 | 2021-11-21 | MongoDB数据库主机 |
| OPAC_MONGODB_PORT | 27017 | 端口号 | 2021-11-21 | MongoDB数据库端口 |
| OPAC_SSM_SCHEME | https | http/https | 2021-11-21 | SSM连接协议（默认https） |
| OPAC_CACHE_ENABLED | True | True/False | 2021-11-21 | 启用/禁用Redis缓存 |
| GA_TRACKING_CODE | G-MKLVK7B5B4 | 跟踪代码 | 2021-11-21 | Google Analytics跟踪代码 |
完整环境变量列表见项目Wiki文档
问题反馈与功能请求
通过GitHub Issues提交问题、Bug报告或功能请求。
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"