culibraries/scholar-saml Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

CU Scholar Repository 镜像文档

镜像概述

CU Scholar Repository是一个基于Samvera Hyrax框架构建的应用镜像，主要用于部署到Kubernetes集群，提供学术资源库的管理与访问功能。该镜像包含完整的应用代码及配置，通过分支管理实现开发、测试与生产环境的分离部署，支持SAML认证等核心功能。

核心功能与特性

• 基于Samvera Hyrax框架，提供数字资源管理能力
• 支持Kubernetes集群部署架构
• 分支管理策略实现环境隔离（开发/测试/生产）
• 集成Solr搜索引擎（需Java 1.8支持）
• 可扩展OAI Provider功能（通过生成器配置）

分支管理

分支流程

<feature branch> --> develop --> release --> master

分支说明

• develop：本地开发分支
  • 本地开发注意事项：需注释config/routes.rb文件中的第15、16、17行，并取消注释第22行
• release：测试分支，已集成SAML认证配置
• master：生产分支，需通过Pull Request合并代码

开发环境设置

依赖项

• Java 1.8：用于启动Solr搜索引擎
• Ruby及Rails：具体版本待补充（详见TODO列表）

调试环境

启动应用调试服务器：

bash
$ bin/rails hydra:server

使用场景与适用范围

• 学术机构数字资源库部署
• 需要Kubernetes集群环境的资源管理系统
• 需支持SAML认证的企业级应用场景

TODO列表

待完善内容：

• Ruby版本规范
• 系统依赖详细清单
• 应用配置说明
• 数据库创建（使用RDS数据库，连接信息通过secrets配置）
• 数据库初始化流程
• 服务组件说明（任务队列、缓存服务器、搜索引擎等）
• 完整部署指南

使用示例

生成OAI Provider配置

bash
$ bin/rails generate blacklight_oai_provider:install

执行后将自动修改以下文件：

• app/models/solr_document.rb
• app/controllers/catalog_controller.rb
• config/routes.rb（两次插入配置）