Sys-ctl-hlth-docker-container Role¶

Description: No description available

Variables¶

author: Kevin Veen-Birkenbach
description: Checks Docker containers for unhealthy or exited states and alerts on any issues.
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’, ‘containers’, ‘health’, ‘systemd’]
repository: https://s.infinito.nexus/code
documentation: https://docs.infinito.nexus

README¶

Docker Container Health Check¶

Description¶

This role monitors the health status of Docker containers on the system. It detects containers that are either unhealthy or have exited with a non-zero code, and triggers alerts if issues are found.

Overview¶

The role installs a health check script along with a systemd service and timer to run these checks at scheduled intervals.

If unhealthy or failed containers are detected, the configured failure notifier (via sys-ctl-alm-compose) is triggered.

Purpose¶

The primary purpose of this role is to ensure that Docker-based services remain operational. By automatically monitoring container health, it enables administrators to react quickly to failures, reducing downtime and preventing unnoticed service degradation.

Features¶

Automated Health Checks: Detects containers in unhealthy state or exited with non-zero exit codes.
Systemd Integration: Installs a one-shot service and timer to run health checks on a schedule.
Alerting Support: Works with the `sys-ctl-alm-compose <../sys-ctl-alm-compose/README.md>`__ role for failure notifications.
Configurable Script Location: Controlled via the PATH_ADMINISTRATOR_SCRIPTS variable.