Files
dns-updater/dns-config/README.md

1.3 KiB

Mail-in-a-Box DNS Configuration Module

The dns-config module provides a command-line interface and a module to configure Mail-in-a-Box's server to delegate a DNS zone to Azure DNS. It retrieves the nameservers for a given Azure DNS zone and sets up the necessary DNS records in Mail-in-a-Box to delegate the zone to Azure DNS.

The module also contains additional commands to list Azure or Mail-in-a-Box DNS records. It can also be used to set, update, add or delete DNS records in Mail-in-a-Box.

Usage

The following commands are available in the dns-config module:

  • list-azure: List Azure DNS records for a given resource group and zone name.
  • list-miab: List Mail-in-a-Box DNS records of a given type (A, CNAME, MX, etc.).
  • set: Set a DNS record in Mail-in-a-Box.
  • add: Add a DNS record in Mail-in-a-Box.
  • delete: Delete a DNS record in Mail-in-a-Box.

Each command has its own --help option that provides more information on how to use it.

To automatically configure an Azure DNS zone in Mail-in-a-Box, you can use the following command:

python -m dns-config configure-miab --resource-group <RESOURCE_GROUP> --zone-name <ZONE_NAME>

Then list the Mail-in-a-Box DNS records to verify that the delegation records have been added:

python -m dns-config list-miab --type NS