kaan/gandi-live-dns-rust
1
0
Fork 0
mirror of https://github.com/SeriousBug/gandi-live-dns-rust synced 2024-12-26 15:19:59 -06:00
Code Issues Projects Releases Wiki Activity
24 commits 5 branches 13 tags 1.8 MiB
Rust 92.9%
Shell 6.8%
Dockerfile 0.3%
Find a file
Kaan Barmore-Genç 19fa71de41 change strip so dependabot can read it
2022-01-30 17:45:45 -05:00
.github fix dependabot config 2022-01-30 17:42:40 -05:00
.vscode almost done! 2021-12-24 20:20:31 -05:00
Docker Rename binary, 1.0.0 release, docker images 2022-01-27 01:22:05 -05:00
Packaging Document AUR package & alternatives 2022-01-30 17:03:57 -05:00
src fix incorrect name on version string 2022-01-30 04:48:24 -05:00
.gitignore package Windows with zip 2022-01-27 15:04:32 -05:00
Cargo.lock fix incorrect name on version string 2022-01-30 04:48:24 -05:00
Cargo.toml change strip so dependabot can read it 2022-01-30 17:45:45 -05:00
example.toml update usage instructions 2022-01-23 22:35:29 -05:00
LICENSE.txt add license 2022-01-23 22:43:06 -05:00
make-release.sh Add packaging for ArchLinux 2022-01-30 04:48:57 -05:00
Readme.md Document AUR package & alternatives 2022-01-30 17:03:57 -05:00
rust-toolchain.toml Rename binary, 1.0.0 release, docker images 2022-01-27 01:22:05 -05:00

Readme.md

gandi-live-dns-rust

A program that can set the IP addresses for configured DNS entries in Gandi's domain configuration. Thanks to Gandi's LiveDNS API, this creates a dynamic DNS system.

If you want to host web services but you don't have a static IP address, this tool will allow you to keep your domains pointed at the right IP address. This program can update both IPv4 and IPv6 addresses for one or more domains and subdomains. It's a one-shot tool that's meant to be managed with a systemd timer or cron.

Usage

This tool doesn't rate limit itself at the moment. If you have more than 30 entries that need to be updated, the operation may hit the rate limit of Gandi and fail. You can work around this using multiple config files and waiting at least 1 minute between runs.

System packages

Packages are available for some linux distributions.

Contributions to release this for other distributions are welcome!

Prebuilt binaries

gandi-live-dns provides pre-built binaries with the releases. See the releases page to get the latest version. These binaries are statically linked, and provided for both Linux and Windows, including ARM architectures for the Linux version.

Download the latest version from the releases page, extract it from the archive, and place it somewhere in your $PATH to use it.

  • Create a file gandi.toml, then copy and paste the contents of example.toml
  • Follow the instructions in the example config to get your API key and put it in the config
  • Follow the examples in the config to set up the entries you want to update
  • Run gandi-live-dns inside the directory with the configration to update your DNS entries

With docker

Use the seriousbug/gandi-live-dns-rust Docker images, which are available for x86_64, arm64, armv6, and armv7 platforms. Follow the steps below to use these images.

  • Create a file gandi.toml, then copy and paste the contents of example.toml
  • Follow the instructions in the example config to get your API key and put it in the config
  • Follow the examples in the config to set up the entries you want to update
  • Run docker run --rm -it -v $(pwd)/gandi.toml:/gandi.toml:ro seriousbug/gandi-live-dns-rust:latest

Docker doesn't support IPv6 out of the box. If you need to update IPv6 addresses, check the linked page to enable IPv6 or use the prebuilt binaries directly.

If you get errors about not finding the config file, make sure your command has a full path to the config file ($(pwd)/gandi.toml part). Otherwise Docker will create a directory.

Automation

The Packaging folder contains a Systemd service and timer, which you can use to automatically run this tool. By default it will update the IP addresses after every boot up, and at least once a day. You can adjust the timer to speed this up, but avoid unnecessarily overloading Gandi's servers.

  • Place gandi-live-dns.timer and gandi-live-dns.service into /etc/systemd/system
  • Put gandi-live-dns binary into /usr/bin/
    • You can also place it in /usr/local/bin or some other directory, just make sure to update the path in the service file
  • Create the folder /etc/gandi-live-dns, and place your gandi.toml into it
  • Create a user for the service: useradd --system gandi-live-dns --home-dir /etc/gandi-live-dns
  • Make sure only the service can access the config file: chown gandi-live-dns: /etc/gandi-live-dns/gandi.toml && chmod 600 /etc/gandi-live-dns/gandi.toml
  • Enable the timer with systemctl enable --now gandi-live-dns.timer

Development

Local builds

cargo build and cargo build --release are sufficient for development and release builds. No special instructions are needed.

Making a release

To make a release, first set up cross and docker. Make sure you log into Docker with docker login. Then follow these steps:

  • bump up the version in Cargo.toml according to semver
  • run ./make-release.sh

    This will build binaries, then package them into archives, as well as build and upload docker images.

  • Create a release on Github
    • Make sure to create a tag for the release version on master
    • Upload the binary archives to the Github release

Alternatives