Around the time of the 2017 PMS guide I made the switch to
docker-compose and it has been happily serving my container lifecycle needs ever since. Here's an screen recording example of updating the containers on the DigitalOcean droplet I use to run my personal blog.
What is docker-compose?¶
docker-compose1 is a tool for defining and running multi-container Docker applications. With docker-compose, a YAML file is used to configure your application’s services. It enables you to use a single command to create, start, stop and destroy the services in your configuration file.
How do I use docker-compose?¶
Here is an example
docker-compose.yaml snippet for Librespeed, a self-hosted speed test app.
--- version: "2" services: librespeed: image: linuxserver/librespeed container_name: librespeed ports: - 8008:80 environment: - PUID=1001 - PGID=1001 - TZ=America/New_York - MODE=standalone - TELEMETRY=true - PASSWORD=badger1
YAML2 stands for Yet Another Markup Language and for correct parsing of these files careful attention to indentations made up of spaces are key. The specific number of spaces in the indentation is unimportant as long as parallel elements have the same left justification and the hierarchically nested elements are indented further.
In short, make sure everything lines up vertically and you'll be OK. Use an editor which highlights spaces for bonus points. VSCode has some nice syntax plug-ins and YAML is one of them.
To create the container defined above copy and paste the above into a file placed at
docker-compose up -d and watch. When the output has finished updating, your Librespeed container will be accessible at
serverip:8008. Try it out!
Quality of life tweaks¶
Bash aliases make dealing with docker-compose much easier. Being a good sysadmin is about being fundamentally lazy and finding ways to reduce the amount of work you have to do. This is where bash aliases come in. Here are some primarily related to docker-compose:
# /etc/bash_aliases # Aliases in this file are available to all users # To install for one user place in ~/.bash_aliases # Tail last 50 lines of docker logs alias dtail='docker logs -tf --tail='50' ' # Shorthand, customise docker-compose.yaml location as needed alias dcp='docker-compose -f ~/docker-compose.yaml ' # Remove unused images (useful after an upgrade) alias dprune='docker image prune' # Remove unused images, unused networks *and data* (use with care) alias dprunesys='docker system prune --all'