This repository has been archived on 2024-02-26. You can view files and clone it, but cannot push or open issues or pull requests.

Go to file

lordwelch 4d1351c52a Reduce requests to the GCP dns backend Update use of the google API to current practices The reduction in requests is achieved by adding a limiter and returning a cached response if the limiter will not allow a request.		2020-05-27 19:01:28 -07:00
cmd/cloud-dyndns-client	Reduce requests to the GCP dns backend	2020-05-27 19:01:28 -07:00
kubernetes	Initial commit	2017-08-30 17:27:42 +09:00
pkg	Reduce requests to the GCP dns backend	2020-05-27 19:01:28 -07:00
.gitignore	Use dep instead of glide	2018-10-22 11:19:17 +09:00
CONTRIBUTING.md	Updated README with better instructions.	2017-08-30 19:02:54 +09:00
Dockerfile	Initial commit	2017-08-30 17:27:42 +09:00
Gopkg.lock	Use dep instead of glide	2018-10-22 11:19:17 +09:00
Gopkg.toml	Use dep instead of glide	2018-10-22 11:19:17 +09:00
LICENSE	Initial commit	2017-08-30 17:27:42 +09:00
README.md	Add IPv6 support	2020-03-10 12:50:51 -07:00
cloudbuild.yaml	Initial commit	2017-08-30 17:27:42 +09:00

README.md

Cloud Dynamic DNS

This project contains a simple Dynamic DNS client that can be used with cloud services. It simply gets your current IP address and sets it to DNS records in backing DNS services. It will do it's best to make sure that the DNS record is always there and set to the desired value, even if something or someone updates or deletes it. It is intended to be used where public internet IPs are assigned dynamically, such as home networks.

Currently cloud-dyndns-client only supports Google Cloud Platform. It is planned to add other DNS APIs as backends.

Prerequisites

cloud-dyndns-client requires Go 1.8.

Install

You can install Go by following these instructions.

cloud-dyndns-client is written in Go, so if you have Go installed you can install it with go get:

go get github.com/ianlewis/cloud-dyndns-client/cmd/cloud-dyndns-client

This will download the code, compile it, and leave an cloud-dyndns-client binary in $GOPATH/bin.

Usage

You need to set set up a DNS provider. Currently only Google Cloud Platform is supported.

Google Cloud Platform

Set up the client to use GCP by first creating a service account.

Create a GCP service account

SA_EMAIL=$(gcloud iam service-accounts --format='value(email)' create cloud-dyndns-client)

Create a JSON key file associated with the new service account

gcloud iam service-accounts keys create service-account.json --iam-account=$SA_EMAIL

Add an IAM policy to the service account for the project.

PROJECT=$(gcloud config list core/project --format='value(core.project)')
gcloud projects add-iam-policy-binding $PROJECT --member serviceAccount:$SA_EMAIL --role roles/dns.admin

Configuration

Create a config.json for the client. Enter the domain name you want to update, the GCP project ID, and Cloud DNS managed zone name. Multiple domains can be added as part of the configuration.

{
  "domains": {
    "mydomain.example.com": {
      "ip4": true,
      "ip6": false,
      "provider": "gcp",
      "provider_config": {
         "project_id": "example-project",
         "managed_zone": "example-zone",
      }
    }
  }
}

Running the client

Start the app and provide the path to the config.json. You need to specify the service account key in the GOOGLE_APPLICATION_CREDENTIALS environment variable.

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
./cloud-dyndns-client -config config.json

Deploy the client to Kubernetes

Create a secret for the json key file

kubectl create secret generic cloud-dyndns-client-service-account --from-file=service-account.json

Deploy the client

kubectl apply -f kubernetes/deploy.yaml

Contributing

Please read CONTRIBUTING.md.

Disclaimers

This is not an official Google product