pmarrone/dspace-dev-docker

dspace-dev-docker镜像说明

镜像概述

本镜像为DSpace开源项目提供即时开发环境，基于Docker Compose构建，包含DSpace开发容器和Postgres数据库容器。目前主要支持Linux系统，旨在解决DSpace开发环境搭建复杂、构建效率低的问题，提供隔离、高效的开发体验。

核心功能

• 热部署支持：集成HotSwap Agent，无需重启Tomcat即可更新已编译类，大幅节省开发时间。
• Tomcat优化：默认配置跳过jar扫描（缩短启动时间）、并行启动上下文（提升启动效率）。
• 环境隔离：将Postgres、Tomcat等依赖封装在容器内，保持本地工作空间整洁。
• 文件系统集成：Linux下无缝挂载本地文件夹，可在主机编辑器中修改代码，避免NFS/VirtualBox共享文件夹的性能问题。
• Mirage2就绪：预装Node、Ruby等依赖，支持快速编译Mirage2主题。
• 快速启动：容器启动仅需数秒，远快于传统虚拟机。

使用场景

• DSpace开源项目开发者搭建本地开发环境。
• 测试DSpace新功能或修复bug时的隔离环境。
• 学习DSpace开发的入门环境。

配置说明

前置要求

1. 安装Docker（参考：https://docs.docker.com/engine/installation/%EF%BC%89%E3%80%82
2. 安装Docker Compose（建议安装二进制版本，参考：https://docs.docker.com/compose/install/%EF%BC%89%E3%80%82
3. 开放端口：8080（Tomcat）、5432（PostgreSQL）、1043（远程调试）、8000（备用调试）；可修改docker-compose.yml调整端口映射。
4. 安装Git。

部署步骤

1. 克隆仓库：

   bash
   git clone https://github.com/pmarrone/dspace-dev-docker.git
   cd dspace-dev-docker
   

2. 创建所需文件夹并克隆DSpace源码：

   bash
   git clone -b dspace-6.0 https://github.com/DSpace/DSpace.git dspace-src
   mkdir m2-repo dspace-build
   

   确保文件夹结构为：dspace-dev-docker包含dspace-src、dspace-build、m2-repo。
3. 修改DSpace配置：
   • 编辑dspace-src/local.cfg，设置dspace.install.dir=/srv/dspace。
   • 修改数据库连接：db.url=jdbc:postgresql://postgres:5432/dspace（默认凭据：dspace:dspace）。
4. 启动容器：

   bash
   docker-compose up -d
   

5. 附加到容器：

   bash
   docker attach dspacedevdocker_dspace-dev_1
   

使用示例

• 编译DSpace（启用Mirage2）：

  bash
  mvn -Dmirage2.on=true -Dmirage2.deps.included=false package
  

• 执行Ant任务（如 fresh_install）：

  bash
  task fresh_install
  

• 启动Tomcat并查看日志：

  bash
  tomcat start && catalina.out
  

• 启动带调试的Tomcat（支持热部署）：

  bash
  tomcat jpda start
  

注意事项

• UID匹配：容器内开发者用户UID默认1000，若主机用户UID不同，需修改Dockerfile重建镜像（调整usermod命令）。
• DSpace版本：当前默认支持DSpace 6.0，若使用其他版本需修改Tomcat配置文件（$CATALINA_HOME/conf/Catalina/localhost下的xml文件）。
• Webapps支持：默认仅启动xmlui和solr，如需其他服务可复制webapps或修改配置文件。