Using Aspose.HTML for Java In Docker

Overview

This guide walks through the process of running Aspose.HTML for Java in a Docker container using a provided Dockerfile for Linux. Docker simplifies application deployment by packaging the application and its dependencies into a container that can run on any system with Docker installed. Follow the steps below to build and run your Docker image.

Requirements

Required libraries for work:

• xorg-x11-server-Xvfb - Xvfb or X virtual framebuffer is a display server implementing the X11 display server protocol. In contrast to other display servers, Xvfb performs all graphical operations in virtual memory without showing any screen output. For more information see: https://en.wikipedia.org/wiki/Xvfb.
• ttf-mscorefonts-installer - Microsoft True Type Core Fonts package.

Step-by-Step Instructions

1. Install Docker:

   • Ensure Docker is installed on your system. You can download it from the Docker website.

2. Prepare Your Dockerfile:

   • A Dockerfile defines the environment and the steps to set up your application. Make sure you have the Dockerfile in your project directory. This file should contain the necessary instructions to build your Docker image.

   FROM registry.access.redhat.com/ubi8/ubi:8.9-1028
   
   ENV FID_HOME=/opt/icgccbfid
   RUN mkdir -p $FID_HOME
   ENV MEDIA=/media/sf_redhat/
   RUN mkdir -p $MEDIA
   RUN chmod -R 775 $MEDIA
   COPY ../../assets $MEDIA
   ENV SERVICE_HOME=$FID_HOME/test-redhat
   RUN mkdir -p $SERVICE_HOME
   RUN chmod -R 775 $SERVICE_HOME
   COPY target/testing-aspose-redhat-jdk-1.0.0.jar $SERVICE_HOME/app.jar
   ENV APP_PATH=${SERVICE_HOME}/app.jar
   
   RUN yum -y --skip-broken install wget
   RUN cd ~
   RUN yum -y install java-1.8.0-openjdk
   RUN ls
   
   # 3. Install Microsoft True Type Core Fonts
   RUN yum -y --skip-broken install -y ttf-mscorefonts-installer fontconfig
   RUN fc-list
   RUN ls
   
   # 4. Copy and install xorg-x11-server-Xvfb package
   COPY xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm /tmp/xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm
   RUN yum -y localinstall /tmp/xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm
   RUN ls
   
   RUN yum -y --skip-broken install rpm
   RUN ls
   
   # 5. Set ENTRYPOINT to run the application with Xvfb
   ENTRYPOINT xvfb-run --server-args="-screen 0 1024x768x24" java -jar app.jar -Djava.awt.headless=false $APP_PATH

3. Install Microsoft True Type Core Fonts:

   • Add the following lines to your Dockerfile to install fonts:

     RUN yum -y --skip-broken install -y ttf-mscorefonts-installer fontconfig
     RUN fc-list
     RUN ls

4. Copy and Install xorg-x11-server-Xvfb Package:

   • Add the following lines to your Dockerfile to copy and install the xorg-x11-server-Xvfb package:

     COPY xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm /tmp/xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm
     RUN yum -y localinstall /tmp/xorg-x11-server-Xvfb-1.20.11-15.el8.x86_64.rpm
     RUN ls

5. Set ENTRYPOINT to Run the Application with Xvfb:

   • Add the following line to your Dockerfile to set the ENTRYPOINT:

     ENTRYPOINT xvfb-run --server-args="-screen 0 1024x768x24" java -jar app.jar -Djava.awt.headless=false $APP_PATH

6. Build the Docker Image:

   • Open your terminal and navigate to the directory containing your Dockerfile.

   • Run the following command to build your Docker image:

      docker build -t my-image .

   • Replace my-image with a name of your choice for the image.

7. Run the Docker Container:

   • Once the image is built, you can run it using the following command:

     docker run -e DISPLAY=:0 -p8080:9999 -p2222:22 --rm my-image

   • Replace host_port with the port on your host machine you want to map.

   • Replace container_port with the port inside the container that your application is using.

   • Replace my-image with the name of your built image.

8. Verify the Container is Running:

   • You can check if your container is running by executing:

     docker ps

   • This command will list all running containers along with their details.

Using Aspose.HTML for Java in Docker simplifies the development and deployment process by providing a consistent environment. Following the steps above, you can easily set up and run Aspose.HTML applications in Docker containers.