giu 0.3.0

Gandi LiveDNS Updater - commnand line tool to keep your dynamic ip up to date

GIU

Gandi LiveDNS Updater - commnand line tool to keep your dynamic ip up to date.

Prequisites

• A valid key fro Gandi LiveDNS API. Use https://account.gandi.net/en/users/USER/security (USER is your Gandi user account).
• Python 3.

Installation

The recommended way to install this package is through pip.

pip install --user giu

Usage

To use giu you need to create a config.toml file to hold the minimal set of configurations.

[api]
url = 'https://dns.api.gandi.net/v5/livedns'
key = 'YOUR_KEY'

[dns]
domain = 'example.com'
records = [
    {'type' = 'A', 'name' = '@', 'ttl' = 18000},
]

[resolver]
providers = [
    'http://ipecho.net/plain',
    'https://ifconfig.me/ip',
    'http://www.mon-ip.fr'
]

One shot

In this example the config file was created on $HOME/.giu/example.com.toml.

giu sync --conf $HOME/.giu/example.com.toml

Cronjob

In this example the config file was created on $HOME/.giu/example.com.toml.

$ crontab -e
* */2 * * * giu sync --conf $HOME/.giu/example.com.toml

Improvements

Some improvements that I have ff the top of my head:

• put command to create entries like CNAMES and so on.
• delete command to delete entries
• backup command to do backups
• Docker Image to run giu with docker compose or as a Cronjob on Kubernetes.