Co-authored-by: Tom Limoncelli <tal@whatexit.org>
1.4 KiB
name | parameters | parameter_types | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
DOMAIN_ELSEWHERE |
|
|
DOMAIN_ELSEWHERE()
is a helper macro that lets you easily indicate that
a domain's zones are managed elsewhere. That is, it permits you easily delegate
a domain to a hard-coded list of DNS servers.
DOMAIN_ELSEWHERE
is useful when you control a domain's registrar but not the
DNS servers. For example, suppose you own a domain but the DNS servers are run
by someone else, perhaps a SaaS product you've subscribed to or a DNS server
that is run by your brother-in-law who doesn't trust you with the API keys that
would let you maintain the domain using DNSControl. You need an easy way to
point (delegate) the domain at a specific list of DNS servers.
For example these two statements are equivalent:
{% code title="dnsconfig.js" %}
DOMAIN_ELSEWHERE("example.com", REG_NAMEDOTCOM, ["ns1.foo.com", "ns2.foo.com"]);
{% endcode %}
{% code title="dnsconfig.js" %}
D("example.com", REG_NAMEDOTCOM,
NO_PURGE,
NAMESERVER("ns1.foo.com"),
NAMESERVER("ns2.foo.com")
);
{% endcode %}
{% hint style="info" %}
NOTE: The NO_PURGE
is used out of abundance of caution but since no
DnsProvider()
statements exist, no updates would be performed.
{% endhint %}