Alexander Schäferdiek
dde06a6da3
All checks were successful
continuous-integration/drone/push Build is passing
87 lines
2.4 KiB
Groff
87 lines
2.4 KiB
Groff
.\" Automatically generated by Pandoc 2.19.2
|
|
.\"
|
|
.\" Define V font for inline verbatim, using C font in formats
|
|
.\" that render this, and otherwise B font.
|
|
.ie "\f[CB]x\f[]"x" \{\
|
|
. ftr V B
|
|
. ftr VI BI
|
|
. ftr VB B
|
|
. ftr VBI BI
|
|
.\}
|
|
.el \{\
|
|
. ftr V CR
|
|
. ftr VI CI
|
|
. ftr VB CB
|
|
. ftr VBI CBI
|
|
.\}
|
|
.TH "docker_check" "1" "January 2023" "docker_check" ""
|
|
.hy
|
|
.SH NAME
|
|
.PP
|
|
docker_check - Checks a set of docker containers and notifies if their
|
|
state is not up and running.
|
|
Configuration is done in environment files.
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
It\[cq]s part of \f[B]system-helpers\f[R].
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\f[B]docker_check\f[R] [CONFIG_FILE (absolute path)]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
\f[B]docker_check\f[R] checks a list of docker containers and notifies
|
|
if their state is not up and running.
|
|
It comes with systemd services.
|
|
.PP
|
|
If no \f[I]CONFIG_FILE\f[R] is provided, \f[B]docker_check\f[R] tries to
|
|
read from \f[I]$HOME/.docker_check.conf\f[R] and
|
|
\f[I]/etc/docker_check.conf\f[R] for configuration.
|
|
It will exit with a non-zero exit code if it cannot find an proper
|
|
configuration file.
|
|
.PP
|
|
The following are at least required for the script to work:
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
- \f[B]DOCKER_CHECK_MAIL_ADDRESS=\[lq]\[lq]\f[R] which requires
|
|
\f[I]mail.rc\f[R] to be configured and `\f[I]mailx\f[R]' command has be
|
|
available.
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
- \f[B]DOCKER_CHECK_LIST_FILE=\[lq]$HOME/.docker_check.list\[rq]\f[R]
|
|
which lists to be checked docker containers separated by lines.
|
|
Provide their container name, e.g.\ output of current running docker
|
|
containers piped into the file: \f[I]docker ps \[en]format `{{.Names}}'
|
|
>> $HOME/.docker_check.list\f[R]).
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
- \f[B]DOCKER_CHECK_NOTIFY_LEVELS=(\[lq]UNKNOWN\[rq] \[lq]WARNING\[rq]
|
|
\[lq]CRITICAL\[rq])\f[R] determines when to notify/output/send mail.
|
|
Possible: \f[I]\[lq]UNKNOWN\[rq]\f[R] \f[I]\[lq]WARNING\[rq]\f[R]
|
|
\f[I]\[lq]CRITICAL\[rq]\f[R] \f[I]\[lq]INFO\[rq]\f[R].
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
- \f[B]DOCKER_CHECK_MAIL_ENABLED=false\f[R] enables or disables sending
|
|
mail notifications.
|
|
.PP
|
|
You can copy this script to \f[I]/usr/local/bin\f[R] and use create a
|
|
custom \f[B]CONFIG_FILE\f[R] as user.
|
|
.SH EXAMPLE
|
|
.PP
|
|
Create a \f[I]$HOME/.docker_check.conf\f[R] and add
|
|
\f[I]DOCKER_CHECK_MAIL_ADDRESS=\[lq]alias\[at]domain.tld\[rq]\f[R].
|
|
Notifications will be delivered to alias\[at]domain.tld.
|
|
Examples can be found in \f[I]/usr/share/doc/docker_check\f[R].
|
|
.SH EXIT VALUES
|
|
.TP
|
|
\f[B]0\f[R]
|
|
Success
|
|
.TP
|
|
\f[B]1\f[R]
|
|
Error
|
|
.SH AUTHORS
|
|
Alexander Sch\[:a]ferdiek.
|