Docker

WebProtégé microservices run in containers, with one service per container. We use Docker for Microservices containerization.

Docker Images

Images for WebProtégé microservices may found on Docker Hub.

To build services you will need to have the docker daemon running. You will also need to have Maven.

All services except the webprotege-gwt-ui service can be built using the mvn clean spring-boot:build-image command. For example, to build the webprotege-authorization-service:

1. Clone the webprotege-authorization-service repository,
   git clone https://github.com/protegeproject/webprotege-authorization-service.git
2. Change to the cloned webprotege-authorization-service directory:
   cd webprotege-authorization-service.
3. Build the image,
   mvn spring-boot:build-image -Dspring-boot.build-image.imageName=protegeproject/webprotege-authorization-service.

Note that if you encounter the error, "Execution default-cli of goal org.springframework.boot:spring-boot-maven-plugin:2.5.3:build-image failed: Connection to the Docker daemon at 'localhost' failed with error [2] No such file or directory; ensure the Docker daemon is running and accessible" this means that Docker Desktop is not running. You should start it and execute the build command again.`

Docker Compose

A Docker Compose file to bring up the services required to run WebProtégé may be found in the webprotege-deploy repository.