Useful code tricks
Last updated
Last updated
Problem: It is difficult to get CAA and other records exactly right.
Solution: Use a "builder" to construct it for you.
You might encounter D() statements in code examples that include END at the end, such as:
As of , the END statements are no longer necessary. These were originally included for historical reasons that are now irrelevant. You can safely remove them from your configurations.
Problem: I have a set of records I'd like to include in many domains.
Solution: Assign a list to a var and use the var in each domain.
Example:
Domains that use Google G-Suite require a specific list of MX records, plus there are some CNAMEs that are useful (but we only want the CNAMEs on a subset of domains).
Problem: We have many domains, each should have the exact same records.
Solution 1: Use a macro.
Solution 2: Use a loop. (Note: See caveats below.)
The dnsconfig.js language is JavaScript. On the plus side, this means you can use loops and variables and anything else you want.
However, we don't recommend you get too fancy.
A new JS interpreter may break your code
Loops and macros are fine. Just don't get too fancy.
Complexity is a killer
As Brian Kernighan wrote, "Debugging is twice as hard as writing the code in the first place. Therefore, if you write the code as cleverly as possible, you are, by definition, not smart enough to debug it."
Sure, you can do a lot of neat tricks with if/thens and macros and loops. Yes, YOU understand the code. However, think about your coworkers who will be the next person to edit the file. Are you setting them up for failure?
And what about You Six Months From Now (YSMFN)? Have you met YSMFN? They're a great person. You'll meet them soon. In about 6 months, I predict. That person is a lot like you, but definitely won't remember how all those clever tricks work. That person also might be tired, sleepy, and possibly drunk. You really want to keep the configuration file simple for YSMFN.
The goal of DNSControl is to empower non-experts to safely make DNS changes. A DNS expert should create the initial configuration, but your non-expert coworkers should be able to send PR and make changes without too much hand-holding. Complexity prevents that.
What to do instead?
Isolate the clever stuff from what a typical user will need to edit.
At Stack Overflow, we put all our macro definitions and fancy stuff at the top of the file. The domains are later in the file.
We name the macros to be easy to understand for the user. For example, we have a few macros named SPF_NONE, SPF_GSUITE, and SPF_domain_tld (where domain_tld is the name of a domain). I bet you can guess which to use for a new domain without seeing the definition.
We also comment extensively. Most records have a comment at the end of the line with the ticket number of the request related to the record. Before each domain there is a long comment explaining why the domain exists, who requested it, any associated ticket numbers, and so on.
Some day we may change from the to something else. This may break your configuration if you depend on unusual or obscure behavior of Otto.
We also comment the individual parts of a record. Look at the example. Each part of the SPF record has a comment.