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 maven image to build jar file
FROM maven:3.8.6-amazoncorretto-17 AS build
WORKDIR /usr/src/app
 

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

# build application with Maven
RUN mvn package -DskipTests

 
# Use the jdk8 image as the basic docker image
FROM eclipse/ubuntu_jdk8
WORKDIR /app
# copy build jar file to target container 
COPY --from=build /usr/src/app/target/*.jar /app/app.jar

# web port
EXPOSE 8080
# If you want to display better, like in Windows, you need to install various fonts in /usr/share/fonts/
# then the application can parse and render the fonts that are used in the spreadsheet file
# here we don't provide extra fonts resources
# 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 that contains the spreadsheet files 
RUN mkdir -p /app/wb
# the file path to store the uploaded files
RUN mkdir -p /app/uploads
# the cache file path for GridJs
RUN mkdir -p /app/grid_cache/streamcache
# we provide some sample spreadsheet 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 -v C:/path/to/license.txt:/app/license --name gridjs-demo-container gridjs-demo-java

or just run the demo in trial mode:

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.
• -v C:/path/to/license.txt:/app/license: Map the license file path on the host machine to the file path in the container.
• --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 an Image

To remove an image, use the following command:

docker rmi gridjs-demo-java