I’m running this blog from a Docker container behind a reverse proxy.
That being said, I’m using volumes to persist my container data. Backing these up requires a bit more work than simply copying files from a to b.
Backup commands using temporary containers
In order to create a backup from a volume, I’m using the following command:
sudo docker run --rm \
--volumes-from <CONTAINER_NAME> \
-v ~/backups:/backups \
ubuntu \
tar cvzf /backups/backup.tar.gz /var/www/htmlThat might be alot. Let’s break it down.
sudo docker runwill start a new container as root. In this case from theubuntuimage (i.e., the image name provided in line 4).- --volumes-from will mount all volumes from the given container name. Of course, you’ll have to replace the placeholder with the name of your container.
- -v ~/backups:/backups will mount the backups folder located in your home directory to a /backups folder in the container we’re starting. We will use this to store the backups we’re about to create.
- ubuntu being the image we’re using to start our disposable backup container.
- Finally there is the actual command to backup the files we want from the WordPress container which are available from the /var/www/html directory. We tar (create an archive containing all files from the given directory) and zip (compress) them with tar cvzf /backups/backup.tar.gz /var/www/html (create verbose zip file).
Once we execute the command all the files from the /var/www/html directory from within our WordPress container will end up in ~/backups/backup.tar.gz and the backup container we just fired will be removed automatically once the tar command has finished.
I will issue a second command just like the above to backup the corresponding MySQL database container.
sudo docker run --rm \
--volumes-from <CONTAINER_NAME> \
-v ~/backups:/backups \
ubuntu \
tar cvzf /backups/backup-db.tar.gz /var/lib/mysqlWe’ve created two zip files in our backup folder. One for the files and one for the database of our WordPress instance.
Let’s build on that.
Automating your backups
Since it would be a bit tedious to fully type out the same commands each time we want to backup our data, let’s automate the process.
As a first step I add all the backup commands for the volumes I want to backup into a script.
#!/bin/bash
docker run --rm \
--volumes-from <CONTAINER_NAME> \
-v ~/backups:/backups \
ubuntu \
tar cvzf /backups/backup.tar.gz /var/www/html
docker run --rm \
--volumes-from <CONTAINER_NAME> \
-v ~/backups:/backups \
ubuntu \
tar cvzf /backups/backup-db.tar.gz /var/lib/mysqlIf I run that script as the non-root user, I’ll run into the following error.
docker: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Head "http://%2Fvar%2Frun%2Fdocker.sock/_ping": dial unix /var/run/docker.sock: connect: permission denied.What’s going on? Well, as you may have noticed, I omitted the sudo command from the docker commands because I plan to call this script from a cron job where I won’t be able to input my password. However the docker command needs root access since Docker is not a rootless installation in this instance.
Let’s tie it all together and add the script to the root user’s cron jobs.
sudo crontab -eAssuming your script resides in a script folder below your home folder, add the following and save.
0 1 * * * ~/scripts/backup.shThis will execute the script with root privileges each night at 1 o’clock in the night.
However, the backup files will belong to the root user. Let’s remedy that.
File permissions
Add the following line to your backup script at the end.
chown $(id -u -n):$(id -g -n) ~/backups/*This will assign ownership and group of all backups to your user.
Summary
We’ve automated daily backups of our Docker volumes using shell scripts and cron jobs. Neat. Let me know what you think.
Oh, and please check these articles for further reading:
Leave a Reply