Page History

...

Overview

...

DSpace publishes a number of Docker images to https://hub.docker.com/u/dspace/

Dockerhub Admins

• Tim Donohue
• Terrence W Brady
• Pascal-Nicolas Becker
• (add other names)

Todo's

•  
• Kim Shepherd 

Docker Images

All Docker images generated by DSpace are built by GitHub Actions.  They use the Docker scripts in the DSpace codebase

• DSpace Backend
  • GitHub action: https://github.com/DSpace/DSpace/blob/main/.github/workflows/docker.yml (This builds/publishes images to DockerHub after every commit)
  • Docker images: https://github.com/DSpace/DSpace/blob/main/dspace/src/main/docker/README.md (These images are what we publish to DockerHub)
  • Docker-Compose scripts: https://github.com/DSpace/DSpace/blob/main/dspace/src/main/docker-compose/README.md (These can be used to run Docker images locally)
• DSpace Frontend
  • GitHub action: https://github.com/DSpace/dspace-angular/blob/main/.github/workflows/docker.yml (This builds/publishes images to DockerHub after every commit)
  • Docker images & compose scripts: https://github.com/DSpace/dspace-angular/blob/main/docker/README.md

Tags in Dockerhub

DSpace uses the following tagging strategy in DockerHub

• "latest" tags correspond to the "main" branch of code under development.  These may be unstable at times, but used to run https://sandbox.dspace.org 
• "dspace-#_x" tags correspond to the maintenance branch in our codebase (e.g. dspace-7_x, dspace-8_x). These are mostly stable and include latest bug fixes.  They are also used to run https://demo.dspace.org 
• "dspace-[version]" tags correspond to a release of DSpace (e.g. dspace-7.6.2, dspace-8.0).  These are stable releases corresponded to the released/tagged code in GitHub.
• Create a Slack channel "dspace-docker"
• Create a build/deploy template script
• Create a repo: DSpace-Labs/Docker-images
• README.md: describe the roll and purpose of the published images, naming conventions, version name conventions.
• /docker-images
  • /minimal
    • Minimally complex docker images to provide basic deployment of DSpace functionality
    • /dspace-postgres
    • /dspace-oracle
    • /dspace-tomcat
    • /dspace-tomcat-mirage2
      
      • A specialized docker image containing Mirage2 build dependencies (applies only to DSpace 5 and Dspace 6)
  • /runtime
    • /dspace-deploy
      • Could we provide dspace images that are already built, or does the licensing of our 3rd party libraries prohibit this?
    • /dspace-dataload
      • Could we provide docker images with ready-to-load test data?
  • /codenvy
    • specialized versions of dspace images built to work around Codenvy dependencies?
  • /janitor
    • specialized versions of dspace images built to work around Codenvy dependencies?
  • /optimized
    • Contains some of the optimizations within https://github.com/DSpace-Labs/dspace-dev-docker
/docker-composeCreate sample docker compose files