Check URLs and manage the respective records in DynDNS.
Project description
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/
Python
Example
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.