mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2025-01-13 02:50:27 +08:00
c547beacc0
* Implement main feature * BIND: Permit printf-like file name formats * BIND: Make filenameformat work forwards and backwards. * Fix extrator test cases
97 lines
3.5 KiB
Markdown
97 lines
3.5 KiB
Markdown
---
|
|
name: D
|
|
parameters:
|
|
- name
|
|
- registrar
|
|
- modifiers...
|
|
---
|
|
|
|
`D` adds a new Domain for DNSControl to manage. The first two arguments are required: the domain name (fully qualified `example.com` without a trailing dot), and the
|
|
name of the registrar (as previously declared with [NewRegistrar](#NewRegistrar)). Any number of additional arguments may be included to add DNS Providers with [DNSProvider](#DNSProvider),
|
|
add records with [A](#A), [CNAME](#CNAME), and so forth, or add metadata.
|
|
|
|
Modifier arguments are processed according to type as follows:
|
|
|
|
- A function argument will be called with the domain object as it's only argument. Most of the [built-in modifier functions](#domain-modifiers) return such functions.
|
|
- An object argument will be merged into the domain's metadata collection.
|
|
- An array argument will have all of it's members evaluated recursively. This allows you to combine multiple common records or modifiers into a variable that can
|
|
be used like a macro in multiple domains.
|
|
|
|
{% include startExample.html %}
|
|
{% highlight js %}
|
|
var REGISTRAR = NewRegistrar("name.com", "NAMEDOTCOM");
|
|
var r53 = NewDnsProvider("R53","ROUTE53");
|
|
|
|
// simple domain
|
|
D("example.com", REGISTRAR, DnsProvider(r53),
|
|
A("@","1.2.3.4"),
|
|
CNAME("test", "foo.example2.com.")
|
|
);
|
|
|
|
// "macro" for records that can be mixed into any zone
|
|
var GOOGLE_APPS_DOMAIN_MX = [
|
|
MX('@', 1, 'aspmx.l.google.com.'),
|
|
MX('@', 5, 'alt1.aspmx.l.google.com.'),
|
|
MX('@', 5, 'alt2.aspmx.l.google.com.'),
|
|
MX('@', 10, 'alt3.aspmx.l.google.com.'),
|
|
MX('@', 10, 'alt4.aspmx.l.google.com.'),
|
|
]
|
|
|
|
D("example.com", REGISTRAR, DnsProvider(r53),
|
|
A("@","1.2.3.4"),
|
|
CNAME("test", "foo.example2.com."),
|
|
GOOGLE_APPS_DOMAIN_MX
|
|
);
|
|
{%endhighlight%}
|
|
{% include endExample.html %}
|
|
|
|
|
|
# Split Horizon DNS
|
|
|
|
DNSControl supports Split Horizon DNS. Simply
|
|
define the domain two or more times, each with
|
|
their own unique parameters.
|
|
|
|
To differentiate the different domains, specify the domains as
|
|
`domain.tld!tag`, such as `example.com!inside` and
|
|
`example.com!outside`.
|
|
|
|
{% include startExample.html %}
|
|
{% highlight js %}
|
|
var REG = NewRegistrar("Third-Party", "NONE");
|
|
var DNS_INSIDE = NewDnsProvider("Cloudflare", "CLOUDFLAREAPI");
|
|
var DNS_OUTSIDE = NewDnsProvider("bind", "BIND");
|
|
|
|
D("example.com!inside", REG, DnsProvider(DNS_INSIDE),
|
|
A("www", "10.10.10.10")
|
|
);
|
|
|
|
D("example.com!outside", REG, DnsProvider(DNS_OUTSIDE),
|
|
A("www", "20.20.20.20")
|
|
);
|
|
|
|
D_EXTEND("example.com!inside",
|
|
A("internal", "10.99.99.99")
|
|
);
|
|
{%endhighlight%}
|
|
{% include endExample.html %}
|
|
|
|
A domain name without a `!` is assigned a tag that is the empty
|
|
string. For example, `example.com` and `example.com!` are equivalent.
|
|
However, we strongly recommend against using the empty tag, as it
|
|
risks creating confusion. In other words, if you have `domain.tld`
|
|
and `domain.tld!external` you now require humans to remember that
|
|
`domain.tld` is the external one. I mean... the internal one. You
|
|
may have noticed this mistake, but will your coworkers? Will you in
|
|
six months? You get the idea.
|
|
|
|
DNSControl command line flag `--domains` is an exact match. If you
|
|
define domains `example.com!george` and `example.com!john` then:
|
|
|
|
* `--domains=example.com` will not match either domain.
|
|
* `--domains='example.com!george'` will match only match the first.
|
|
* `--domains='example.com!george',example.com!john` will match both.
|
|
|
|
NOTE: The quotes are required if your shell treats `!` as a special
|
|
character, which is probably does. If you see an error that mentions
|
|
`event not found` you probably forgot the quotes.
|