This book contains a number of examples that run inside docker containers, for standardization across different operating systems.
This section will help you install Docker and familiarize yourself with some of the most commonly used Docker commands, so that you can run the book’s example containers.
Before we begin, you should install the Docker container system on your computer. Docker is an open system that is distributed for free as a Community Edition for many different operating systems including Windows, Mac OS and Linux. The Windows and Mac versions are called Docker Desktop and consist of a GUI desktop application and command-line tools. The Linux version is called Docker Engine and is comprised of a server daemon and command-line tools. We will be using the command-line tools, which are identical across all platforms.
Go ahead and install Docker for your operating system by following the instructions to "Get Docker" from the Docker website found here:
Select your operating system from the list and follow the installation instructions.
|
Tip
|
If you install on Linux, follow the post-installation instructions to ensure you can run Docker as a regular user instead of user root. Otherwise, you will need to prefix all docker commands with sudo, running them as root like: sudo docker. |
Once you have Docker installed, you can test your installation by running the demo container hello-world like this:
$ docker run hello-world Hello from Docker! This message shows that your installation appears to be working correctly. [...]
In this chapter, we use Docker quite extensively. We will be using the following Docker commands and arguments:
Building a container
docker build [-t tag] [directory]
…where tag is how we identify the container we are building, and directory is where the container’s "context" (folders and files) and definition file (Dockerfile) are found.
Running a container
docker run -it [--network netname] [--name cname] tag
…where netname is the name of a Docker network, cname is the name we choose for this container instance and tag is the name tag we gave the container when we built it.
Executing a command in a container
docker exec cname command
…where cname is the name we gave the container in the run command, and command is an executable or script that we want to run inside the container.
Stopping and starting a container
In most cases, if we are running a container in an interactive as well as terminal mode, i.e. with the i and t flags (combined as -it) set, the container can be stopped by simply pressing CTRL-C or by exiting the shell with exit or CTRL-D. If a container does not terminate, you can stop it from another terminal like this:
docker stop cname
To resume an already existing container use the start command, like so:
docker start cname
Deleting a container by name
If you name a container instead of letting Docker name it randomly, you cannot reuse that name until the container is deleted. Docker will return an error like this:
docker: Error response from daemon: Conflict. The container name "/bitcoind" is already in use...To fix this, delete the existing instance of the container:
docker rm cname
…where cname is the name assigned to the container (bitcoind in the example error message)
List running containers
docker ps
…shows the current running containers and their names
List docker images
docker image ls
…shows the docker images that have been built or downloaded on your computer