Docker installation tutorial - Storm Streaming Server

Docker is a great way to deploy the Storm Streaming Server on your server infrastructure. This guide provides detailed instructions on how to install Docker on Linux (Debian-based distributions), Windows, and macOS. All Storm Streaming Server Docker images come with the JVM pre-installed, so there is no need to set it up manually. Once Docker is up and running on your machine, please refer to our Docker Installation guide.

If you are unfamiliar with Docker and its concepts, we highly recommend checking docker.com for more information.

Installing Docker on Linux

This guide is specifically for Debian (including Ubuntu and Mint), but the overall process will not differ significantly for other Linux-based operating systems like RedHat or Fedora. In the first step, we will ensure that we obtain the latest version of Docker directly from the Docker repository (as the packages provided by Debian might not be the latest).

First, update the existing package list:

                        
sudo apt update
                    

Next, install a few prerequisite packages that allow apt to use packages over HTTPS:

                        
sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common
                    

Then add the GPG key for the official Docker repository to your system:

                        
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add
                    

Add the Docker repository to APT sources:

                        
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
                    

Next, update the package database with the Docker packages from the newly added repo:

                        
sudo apt update
                    

Make sure you are about to install from the Docker repo instead of the default Debian repo:

                        
apt-cache policy docker-ce
                    

You’ll see output like this, although the version number for Docker may be different:

                        
docker-ce:
  Installed: (none)
  Candidate: 5:20.10.7~3-0~debian-buster
  Version table:
    5:20.10.7~3-0~debian-buster 500
      500 https://download.docker.com/linux/debian buster/stable amd64 Packages
              ...
                    

Finally, install Docker:

                        
sudo apt install docker-ce
                    

Docker is now installed, the daemon is started, and the process is enabled to start on boot. Check that it is running:

                        
● docker.service - Docker Application Container Engine
  Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
  Active: active (running) since Mon 2021-06-28 13:55:43 CEST; 1min 33s ago
   Docs: https://docs.docker.com
 Main PID: 14558 (dockerd)
   Tasks: 24
  Memory: 56.9M
  CGroup: /system.slice/docker.service
     └─14558 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
                    

Adding user privileges for docker

By default, the docker command can only be run the root user or by a user in the docker group, which is automatically created during Docker’s installation process. If you attempt to run the docker command without prefixing it with sudo or without being in the docker group, you’ll get an output like this:

                        
docker: Cannot connect to the Docker daemon. Is the docker daemon running on this host?.
See 'docker run --help'.
                    

If you want to avoid typing sudo whenever you run the docker command, add your username to the docker group:

                        
sudo usermod -aG docker $USERNAME
                    

Installing Docker on Windows

Docker for Windows operating system is available for download with an easy-to-use installer. You can grab it form here: https://www.docker.com/products/docker-desktop , Once the package is download just double-click the exe file and follow instructions to the end.

Installing Docker on Mac OS

Docker for Mac OS also is available for download with a friendly installer: https://www.docker.com/products/docker-desktop

Useful links

1. Docker commands - https://docs.docker.com/engine/reference/commandline/docker/