Docker’s process based virtualization has many advantages, especially when combined with the benefits of image layers. It allows for incredibly fast container spawning and light weight resource utilization. However, one of the side effects of Docker’s ephemeral process model is that you have to be certain to plan when you want to save persistent data. In this guide, we’ll introduce you to Docker’s native solution to this problem: volumes.
Let’s engage in a hypothetical. Suppose we drop into a shell inside of a busybox container:
docker run -it --rm busybox
Then, let’s write some data to a location, say, /tmp:
echo "Data!" > /tmp/data
We can see that the data definitely get written. But where do the data actually go?
As we learned earlier, Docker images consist of layers stacked on top of each other to result in a final image. Each of these layers contains data changed in an operation such as installing a tool, adding source code, etc. Each one of these layers becomes read-only after its creation.
When a container is created from an image, a thin R/W layer is added on top of the previous image layers. This layer handles all write calls from the container that would otherwise be directed at the read-only layers beneath.
Remember that containers are ephemeral by nature. They are meant to have a specific lifetime and to die at some point like any process. The thin read/write layer is also ephemeral — it disappears along with the container.
So, any writes that we perform in the container are limited to that container’s lifetime. They will disappear when the container is destroyed. This is an obvious limitation that is not conducive to storing stateful information. So, how do developers and administrators work around this?
They use Docker volumes.
Docker volumes are a way to create persistent storage for Docker containers. Docker volumes are not tied to the container lifetime, so any writes to them will not disappear when the container does. They also can be re-mounted to one or more containers so you can share data and connect new containers to existing storage.
Docker volumes work by creating a directory on the host machine and then mounting that directory into a container (or multiple containers). This directory exists outside of the layered image that normally comprises a Docker container, so it’s not subject to the same rules (read-only, etc).
Let’s create a Docker volume and see this in action:
docker volume create
A simple call to docker volume create will create a new volume. If we inspect this volume, we can see where it lives on the host filesystem:
docker volume inspect 1d358c3fc3750f98345713eee5c294dee526a3f5d0bd41a0ff4d117218c4af73
There’s a lot of information that comes with this inspect call, but all we’re really concerned with right now is the Mountpoint. Notice that is lists a path starting with /var/lib/docker.... If you were to open that path on your machine running Docker, you could view the data stored inside of this volume.
The method we just used to create a volume isn’t the only way. When running a container, you can specify -v to create a new volume on the fly:
docker run -it --rm -v testdata:/data busybox
As you can see, we have added a new argument to our docker run command: -v. There is a special syntax for this argument, with fields being separated by colons. The first field is the name of the volume, so in this case, testdata. The second field is the path on the container where the volume should be mounted, so in this case, /data. Let’s write data to the volume from within the container:
echo "Hello!" > /data/hello
That the data is visible from outside of the container, in the volume path on the host:
Something you may have also noticed is that the path is no longer a randomized
string — it is now the name of the volume we specified when we used the -v argument.
Docker volumes can have either randomized names initialized by the Docker
Engine, or the user can specify a name for the volume. Names must be unique per
Our created-at-runtime Docker volume also now becomes available in the docker volume ls command:
docker volume ls
DRIVER VOLUME NAME
That means we can use this volume again with another container, or even multiple containers. Let’s test this out now.
First, connect the volume to a busybox container:
Inside the container, let’s print the system information and then write to the volume:
echo "Hello 2" > /data/hello
Linux 7e299450b997 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 x86_64 GNU/Linux
Now, start up a second busybox container running at the same time:
We can see the data that was written in the first container:
Linux c5bf9ca04d3a 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 x86_64 GNU/Linux
This highlights another strength of Docker volumes: sharing data between containers.
There are many valid use cases for Docker containers, but we will cover the two most common ones here.
For each of these examples, let’s pretend that we have a simple application that runs and collects data from some weather sensors. We want to gather a bunch of weather metrics, store them, and then use them again in the future. Let’s call our sample application WeatherMon.
If we run WeatherMon without using Docker volumes, any data that we collect will be destroyed when the container disappears. That’s not very helpful if our goal is to collect data and have it available for future use.
Docker volumes are handy because we can persist our data to the volume and have it remain outside of the container’s lifetime. Perhaps we create our container by calling docker run with the argument -v weathermon:/opt/weathermon. Then our application can store its weather metrics in the /opt/weathermon directory inside of directly on the ephemeral read/write layer provided by the container.
We could alternatively setup a remote database to store this information, but volumes provide an alternative for persisting local-only data.
Let’s say we’ve been running our WeatherMon application for a while now and have collected quite a bit of data. We wish to run some analytics against this data to determine information such as the average temperature per day, or which week in a month had the highest average humidity.
Using Docker volumes, we can mount this existing volume into a new container, WeatherMon-Analytics. This new container can read in the data without interrupting collection from WeatherMon. It can then perform the analytics we desire, and store that information into the same volume or to a different volume if desired.
This also overlaps with a third use-case: pulling in large amounts of data to a container.
If we didn’t use Docker volumes, we may have to copy all of the required data into the container at runtime. That could be very expensive and slow, especially if we’re working with data like gigabytes of weather metrics.
By using Docker volumes we can simply mount the data volume to the container and start our application. No data loading is required.
There are two other types of Docker volumes that we haven’t discussed yet: bind mounts and tempfs mounts.
Bind mounts are used to mount an existing path on the host machine into a container. Using --mount combined with <host path>:<container path>, you can specify existing directories to be mounted into a container.
<host path>:<container path>
This is very handy when presenting configuration information, such as directories from within /etc. It is also useful for when you have information that you wish for a container to use, such as existing data sets or static website files for example.
The job of the tempfs mount is to provide a writable location that specifically does not persist information after the lifetime of the container. You may be thinking, “why would that be necessary?”
In a container that does not have a volume mounted, any writes go into the thin R/W layer inserted at runtime. Any writes directed to that layer impact the filesystem as those writes are executed on the underlying host.
This normally is not a problem unless you are writing significant amounts of disposable data (such as logs). In that case you may witness performance degradation as the filesystem needs to handle all of those write calls.
The tempfs mount was created to provide containers a disposable write path that does not impact filesystem operations. Specifically, the tempfs mount is an ephemeral mount that writes directly to memory. You can create this volume by using the --tempfs argument.
By default, volumes store information on the underlying host system. Docker also has a concept called volume drivers that allow you to specify how and where to store volumes. For instance, you could store a Docker volume inside of an Amazon S3 bucket. This can be handy if you wish information to persist not only outside of the container’s lifetime, but outside of the host’s lifetime as well.
All of the concepts discussed here are broken down in much more detail in Docker’s documentation about storage. Examples of how to use each type of mount and a more in-depth introduction to the concept of volume drivers are available at that link.