Gandi LiveDNS Updater - commnand line tool to keep your dynamic ip up to date
Project description
GIU
Gandi LiveDNS Updater - Command 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
Docker
In this example the config is mounted as part of a config folder.
docker run -it --rm -v config-folder:/tmp/ yriveiro/giu:latest giu sync --config /tmp/config.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 entriesbackup
command to do backupsDocker Image to run giu with docker compose or as a Cronjob on Kubernetes.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
giu-0.3.1.tar.gz
(7.2 kB
view hashes)
Built Distribution
giu-0.3.1-py3-none-any.whl
(7.7 kB
view hashes)