University of Michigan Library containerization of DSpace
A source image is created by pulling source code from the library's forks of DSpace: https://github.com/mlibrary/dspace-angular and https://github.com/mlibrary/DSpace. The source image is then used to create the frontend, backend, and solr images. These images, along with a database image, are then configured and deployed to create an instance of the DSpace application.
Essentially there are two, for lack of a better word, contexts: local and remote. Local will be used to refer to your local development environment, or more specifically, Docker Desktop. Remote will be used to refer a Kubernetes cluster. The primary differences between these two contexts being how images are built, where they are stored, and how they are deployed. Local images are built via the docker compose build command, stored locally in Docker Desktop, and deployed via docker compose up -d command. Remote images are built via GitHub Actions, stored remotely in GitHub Packages, and deployed to Kubernetes (OpenShift) typically using kubectl (oc) to apply the appropriate deployment yaml files.
It is recommend that you first get an instance of DSpace running locally via docker compose prior to attempting to get an instance of DSpace running remotely in Kubernetes.
docker logindocker compose buildNOTES:
Build uses umich by default. To build with issue-working, use "--build-arg GITHUB_BRANCH=issue-working"
Build uses dspace-7.6 by default. To build with 7_x, use "--build-arg DSPACE_VERSION=7_x"
Build uses JDK11 by default. To build with JDK17, use "--build-arg JDK_VERSION=17"
docker compose up -d| URL | Container | Comments |
|---|---|---|
| http://localhost:4000/home | frontend | Angular GUI |
| jdbc:postgresql://localhost:5432/dspace | db | PostgreSQL (user: dspace, password: dspace) |
| http://localhost:8009/ | backend | debugging??? |
| http://localhost:8080/rest | backend | REST API (Deprecated) |
| http://localhost:8080/server | backend | Server API |
| http://localhost:8888/ | apache | Apache Web Server |
| http://localhost:8983/solr | solr | Solr GUI |
| http://localhost:9876/ | frontend | debugging??? |