azure-dns-update/README.md

39 lines
1.1 KiB
Markdown
Raw Permalink Normal View History

2022-07-14 00:56:34 +00:00
<h1>Azure DNS Update</h1>
A utility that can be used to keep your Azure DNS pointed to your on-premises/home public IP address.
<br>
## Features
2022-08-20 18:09:55 +00:00
- Supports updating multiple DNS Zones at once
2022-07-14 00:56:34 +00:00
- Can be run on a schedule
- Can be run as a Docker container
2022-08-20 18:09:55 +00:00
## Prerequisites
The following steps should be completed before this tool will become functional:
- Create a new Azure DNS Zone on https://portal.azure.com
- Purchase a domain and configure it's nameservers to point to Azure DNS
- Create an ```A``` record with value ```@```
- Configure the Settings as described below in the .env file
2022-07-14 00:56:34 +00:00
## Settings
These settings must be configured in a .env file in the same directory as the script.
```bash
SUBSCRIPTION_ID=<YOUR_SUBSCRIPTION_ID_GUID>
CLIENT_ID=<YOUR_CLIENT_ID_GUID>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
TENANT_ID=<YOUR_TENANT_ID_GUID>
2022-08-20 18:09:55 +00:00
RESOURCE_GROUP_NAMES="<YOUR_RESOURCE_GROUP_NAMES_SPACE_DELIMITED>"
ZONE_NAMES="<YOUR_DNS_ZONE_NAMES_SPACE_DELIMITED>"
2022-07-14 00:56:34 +00:00
RECORD_TYPE=A
RELATIVE_RECORD_SET_NAME=@
```
2022-08-20 18:09:55 +00:00
## Usage
To run, simply configure the .env file and run the update-dns.sh script.