ddcheck
Check URLs and manage the respective records in DynDNS.
Description
ddcheck
accepts a list of healthckeck URLs, resolve them to IPs and makes
HTTP requests directly to the IPs. When given IP is recognized as down, it will
remove the record from DynDNS
Features
- IPv4 and IPv6 support (A and AAAA records in DNS)
- Traversing over CNAMEs to target A/AAAA records
- IP is marked as failed when it either timeouts (configurable in seconds) or returns defined HTTP code (for example 500, by default turned off)
- Dry run mode: Will not change the DynDNS recods. Outputs only
curl
commands instead. - Will not delete IPs from DynDNS, when all the IPs in the dns record fail.
Installation
pip install 'git+https://github.com/whiskybar/ddcheck.git#egg=ddcheck'
Usage
CLI
DynDNS credetials can be defined either by env variables, or as parameters.
# ddcheck --help usage: ddcheck [-h] [-d] [-e ERROR_CODES] [-t TIMEOUT] [-D] [--dynect-customer DYNECT_CUSTOMER] [--dynect-user DYNECT_USER] [--dynect-password DYNECT_PASSWORD] URL [URL ...] Run a ddcheck. positional arguments: URL URL to check optional arguments: -h, --help show this help message and exit -d, --debug Debug logging on -e ERROR_CODES, --error-codes ERROR_CODES HTTP codes considered as non-OK -t TIMEOUT, --timeout TIMEOUT URL timeout -D, --dry-run Do not really update the dyndns. Just print records to delete. --dynect-customer DYNECT_CUSTOMER Customer name in DynEct (defaults to DYNECT_CUSTOMER_NAME env variable) --dynect-user DYNECT_USER Username in DynEct (defaults to DYNECT_USER_NAME env variable) --dynect-password DYNECT_PASSWORD Password in DynEct (defaults to DYNECT_PASSWORD env variable)
Example
export DYNECT_PASSWORD=aaa export DYNECT_USER_NAME=bbb export DYNECT_CUSTOMER_NAME=ccc ddcheck -e 500 --debug --dry-run http://root.example1.com/health/ http://cname.example2.com/check/