Sys-ctl-hlth-docker-volumes Role

Description: No description available

Variables

• author: Kevin Veen-Birkenbach

• description: Detects anonymous Docker volumes not bound to containers (unless whitelisted) and alerts.

• company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

• license: Infinito.Nexus NonCommercial License

• license_url: https://s.infinito.nexus/license

• min_ansible_version: 2.9

• platforms: [{‘name’: ‘Archlinux’, ‘versions’: [‘rolling’]}]

• galaxy_tags: [‘monitor’, ‘docker’, ‘volumes’, ‘health’, ‘systemd’]

• repository: https://s.infinito.nexus/code

• documentation: https://docs.infinito.nexus

README

Docker Volumes Health Check

Description

This role detects unused anonymous Docker volumes that are not bound to any running container.

It can optionally exclude specific volumes from the check using a configurable whitelist.

Overview

The role installs a script and a systemd service with a timer to periodically scan for leftover anonymous volumes.

This helps prevent wasted disk space and leftover resources from old deployments.

Purpose

The main purpose of this role is to keep Docker environments clean by identifying and reporting orphaned anonymous volumes.

It supports a whitelist mechanism to avoid alerting on known or intentional volumes.

Features

• Anonymous Volume Detection: Identifies volumes with 64-character IDs not attached to any container.

• Whitelist Support: Skips volumes listed in DOCKER_WHITELISTET_ANON_VOLUMES.

• Bootstrap Volume Exclusion: Ignores known bootstrap volumes (e.g., /var/www/bootstrap).

• Systemd Integration: Installs a one-shot service and timer to automate checks.

• Alerting Support: Works with the `sys-ctl-alm-compose <../sys-ctl-alm-compose/README.md>`__ role for failure notifications.

Further Resources

• Docker Volumes Documentation

• Systemd Timers Documentation

• ChatGPT Create Conversation.