The Hofmeister XIX project is a TEI XML-based project published via, Apache Cocoon, a Tomcat web application. Recently, the project has been containerised using Docker Compose to enhance deployment efficiency and sustainability. The containerised setup comprises three main services: an nginx proxy, a Tomcat server, and an nginx server.
nginx-proxy: This service acts as a reverse proxy, dynamically routing incoming HTTP requests to the appropriate backend services based on the requested hostname and path. It ensures that traffic is directed correctly and efficiently within the application infrastructure.tomcat: This service hosts the Java-based web application. It is responsible for processing and delivering dynamic content generated from the TEI XML data. The Tomcat server is configured to handle substantial traffic and resource-intensive operations.nginx: This service is dedicated to serving static assets, images, and other resources required by the web application. By offloading the delivery of static content to a separate server, it improves the overall performance and responsiveness of the web application.
Follow these steps to set up and run the Hofmeister XIX project using Docker Compose.
Note that these instructions cover only the local setup; server deployment is not covered here.
Before you begin, ensure you have the following installed on your system:
-
Clone this repository
-
Start the services
Use the provided helper script
docker.shto build and start the services:./docker.sh
-
Access the application
Once all services are running, you can access the web application via your web browser at http://localhost/.
To stop the application press CTRL+C in the same terminal window where the docker.sh script is running.