Playbooks

The Docker module provides a default playbook docker.yml for installing Docker Daemon and Docker Compose.

docker.yml

Playbook source file: docker.yml

Running this playbook will install docker-ce and docker-compose-plugin on target nodes with the docker_enabled: true flag, and enable the dockerd service.

The following are the available task subsets in the docker.yml playbook:

• docker_install : Install Docker and Docker Compose packages on the node
• docker_admin : Add specified users to the Docker admin user group
• docker_dir : Create Docker related directories
• docker_config : Generate Docker daemon service configuration file
• docker_launch : Start the Docker daemon service
• docker_register : Register Docker daemon as a monitoring target (alias tags: register / add_metrics)
• docker_image : Attempt to load pre-cached image tarballs from /tmp/docker/*.tgz (if they exist)

The Docker module does not provide a dedicated uninstall playbook. If you need to uninstall Docker, you can manually stop Docker and then remove it:

systemctl stop docker                        # Stop Docker daemon service
yum remove docker-ce docker-compose-plugin   # Uninstall Docker on EL systems
apt remove docker-ce docker-compose-plugin   # Uninstall Docker on Debian systems

Changing docker_enabled to false only makes docker.yml skip the entire Docker role. It does not stop or uninstall an existing Docker deployment, nor delete /data/docker. The manual commands above also leave the data directory in place. Docker’s VictoriaMetrics file-discovery target can be deregistered together with the node through the node_deregister task in node-rm.yml.