Skip to content

Latest commit

 

History

History
31 lines (20 loc) · 1.36 KB

README.md

File metadata and controls

31 lines (20 loc) · 1.36 KB
Raw

Dynamic Cloud DNS

Simple yet secure Python script to update DNS record in Google Cloud DNS according to your current IP address.

Features

  • Google API Clients & gcloud not required
  • Updates Cloud DNS record using your current IP address
  • Uses service account based authentication

What does it do exactly?

This script updates a pre-defined DNS type "A" record in Google Cloud DNS according to the current public IP address of the caller. (i.e. your machine)

When combined with a scheduler, this effectively acts as a Dynamic DNS (DDNS) service for Google Cloud DNS.

Architecture Diagram

cloud-dns-ip-updater drawio

Installation

  1. Deploy the Cloud Functions (/functions of this repo) and grant it permissions to change Cloud DNS resources.
  2. Create a service account for the script and grant it permission to invoke Cloud Functions.
  3. Generate a new JSON keyfile of the created service account and store it into your machine.
  4. Install all necessary python packages (i.e. pip install -r requirements.txt)

How to use

  1. Create and fill in the variables required in .env file. Refer to .env.template.
  2. python3 main.py (or python main.py if you are using virtualenv)
  3. (optional) Set a crontab to regularly update the DNS record set!