Building a Docker Image with SnappyData Binaries¶

The following instructions outline how to build a Docker image if you have the binaries of SnappyData.

Before building the Docker image, ensure the following:

• You have Docker installed, configured, and it runs successfully on your machine. Refer to the Docker documentation for more information on installing Docker.
• The Docker containers have access to at least 4GB of RAM on your machine.

Verifying Docker Installation¶

In the command prompt, run the command:

$ docker run hello-world

Building Docker Image of SnappyData¶

You can use the Dockerfile that is provided and create your own Docker image of SnappyData. Download the Dockerfile script and place it into a directory. The Dockerfile contains a link to the latest SnappyData OSS version to build the image.

Move into the directory containing the downloaded Dockerfile and then run the Docker build command with the required details to build the Docker image. You can create an image using any one of the following options:

• Building Image from the Latest Version of SnappyData OSS
• Building Image from a URL Directing to SnappyData Binaries
• Building Image from Local Copy of SnappyData Product TAR file

Building Image from the Latest Version of SnappyData OSS¶

By default, the Dockerfile creates a Docker image from the latest version of SnappyData OSS.

$ docker build -t <your-docker-repo-name>/<image_name>[:<image-tag>] .

For example:

The following command builds an image with tag latest:

$ docker build -t myrepo/snappydata .

The following command builds an image with tag 1.3.1:

$ docker build -t myrepo/snappydata:1.3.1 .

Building Image from a URL Directing to SnappyData Binaries¶

If you want to create a Docker image from any of the previous versions of SnappyData, you can specify the URL of the tarfile in the build command.

$ docker build -t <your-docker-repo-name>/<image_name>[:<image-tag>] . --build-arg TARFILE_LOC=<public-url>

For example:

$ docker build -t myrepo/snappydata . --build-arg TARFILE_LOC=https://github.com/TIBCOSoftware/snappydata/releases/download/v1.3.1/snappydata-1.3.1-HF-1-bin.tar.gz

Building Image from Local Copy of SnappyData Product TAR file¶

If you have already downloaded the SnappyData tarfile locally onto your machine, use the following steps to build an image from the downloaded binaries. To download SnappyData, refer to the Provisioning SnappyData section in the product documentation.

Copy the downloaded tar.gz file to the Docker folder where you have placed the Dockerfile and run the following command:

$ docker build -t <your-docker-repo-name>/<image_name>[:<image-tag>] . --build-arg TARFILE_LOC=<tarfile name>

For example:

$ docker build -t myrepo/snappydata . --build-arg TARFILE_LOC=snappydata-1.3.1-HF-1-bin.tar.gz

Verifying Details of Docker Images¶

After the Docker build is successful, you can check the details for Docker images using the docker images command.

For example:

$ docker images

Publishing Docker Image¶

If you want to publish the Docker image onto the Docker Hub, login to the Docker account using docker login command, and provide your credentials. For more information on Docker login, visit here. After a successful login, you can publish the Docker image using the docker push command.

$ docker push <your-docker-repo-name>/<image_name>[:<image-tag>]

Ensure to use the same name in the docker push that is used in docker build.

For example:

$ docker push myrepo/snappydata

Launching SnappyData Container¶

The command to launch SnappyData container is different for Linux and macOS.

Launching SnappyData Container on Linux¶

In the command prompt, execute the following commands to launch the SnappyData cluster in a single container.

$ docker run -itd --net=host --name <container-name> <your-docker-repo-name>/<image_name>[:<image-tag>] start all

# -i: keep the STDIN open even if not attached.
# -t: Allocate pseudo-TTY.
# -d: Detach and run the container in background and print container ID.
# --net=host: Use the Docker host network stack.

If the image is not available locally, this fetches the Docker image from the Docker registry, launches a default cluster consisting of one data node, one lead, and one locator in a container.

$ docker run -itd --net=host --name snappydata myrepo/snappydata start all

Launching SnappyData Container on macOS¶

If you are using macOS, you must redirect the ports manually using -p parameter. If you use --net=host, it may not work correctly on the macOS. You can use the following modified command for macOS:

$ docker run -d --name=snappydata -p 5050:5050 -p 1527:1527 -p 1528:1528 myrepo/snappydata start all -hostname-for-clients=<Machine_IP/Public_IP>

The -hostname-for-clients parameter sets the IP Address or Hostname that the server listens for client connections. The command may take few seconds to execute.

Commonly used Docker Commands¶