how to run Aspose.Cells.GridJs in docker

Docker Guide

Prerequisites

Ensure you have Docker installed on your machine. You can download and install Docker from the official Docker website.

Step 1: Create a Dockerfile

Create a file named Dockerfile in your project directory. The Dockerfile should contain instructions on how to build your Docker image.

Step 2:Write Dockerfile for GridJs

Here is a sample Dockerfile for GridJs demo with java application:

# Use the jdk8 image
FROM eclipse/ubuntu_jdk8
WORKDIR /usr/src/app
 

# copy local Maven files to container
COPY mvnw .
COPY .mvn .mvn
COPY pom.xml .
COPY src src

# build application with maven
RUN ./mvnw package -DskipTests

# Set the user
USER root

#RUN ls -l *

# copy the build output jar to container
COPY  target/*.jar /app/app.jar

# delete build source to reduce storage usage
RUN rm -rf target && rm -rf .mvn && rm -rf src
# web port
EXPOSE 8080
# if you want display better like in windows ,you need to install kinds of fonts in /usr/share/fonts/ 
# then the application can parse and render the fonts which is used in the spread sheet file
# here we don't provide extra fonts resource
# Install Fonts because the SDK image contains very few fonts. The command copies font files from local to docker image. Make sure you have a local “fonts” directory that contains all the fonts you need to install. In this example, the local “fonts” directory is put in the same directory as the Dockerfile.
# COPY fonts/* /usr/share/fonts/
# the basic file path which contains the spread sheet files 
RUN mkdir -p /app/wb
# the cache file path for GridJs
RUN mkdir -p /app/grid_cache/streamcache
# we provide some sample spread sheet files in demo 
COPY wb/*.xlsx /app/wb/

# set the start command for the docker image 
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app/app.jar"]

Step 3: Building the Docker Image

Build the Docker Image: From the terminal, execute the following command to build your Docker image:

docker build -t gridjs-demo-java .

you can replace gridjs-demo-java with the name you want to give your Docker image.

Step 4: Running a Docker Container

Once the image is built, you can run a container using the following command:

docker run -d -p 8080:80 --name gridjs-demo-container  gridjs-demo-java

Explanation of Docker Run Command Options -d: Run the container in detached mode (in the background). -p 8080:80: Map port 80 in the container to port 8080 on the host machine. –name gridjs-demo-container: Assign a name to the container.

Step 5: Verify the Container is Running

To check if your container is running, use the following command:

docker ps

This will list all running containers. You should see your container listed along with its name and status.

Step 6: Access The Web Application

Open a web browser and go to http://localhost:8080/gridjsdemo/index. You should see your application running.

Additional Commands

Stopping the Container

To stop a running container, use the following command:

docker stop gridjs-demo-container

Removing a Container

To remove a stopped container, use the following command:

docker rm  gridjs-demo-container

Removing a Image

To remove an image, use the following command:

docker rmi gridjs-demo-java