Linode provider

OWNERS

@@ -5,6 +5,7 @@ providers/digitalocean @Deraen
 providers/dnsimple @aeden
 providers/gandi @TomOnTime
 # providers/gcloud
+providers/linode @koesie10
 providers/namecheap @captncraig
 # providers/namedotcom
 providers/ns1 @captncraig

README.md

@@ -20,6 +20,7 @@ Currently supported DNS providers:
  - DNSimple
  - Gandi
  - Google
+ - Linode
  - Namecheap
  - Name.com
  - NS1

docs/_includes/matrix.html

@@ -13,6 +13,7 @@
 	<th class="rotate"><div><span>DNSIMPLE</span></div></th>
 	<th class="rotate"><div><span>GANDI</span></div></th>
 	<th class="rotate"><div><span>GCLOUD</span></div></th>
+	<th class="rotate"><div><span>LINODE</span></div></th>
 	<th class="rotate"><div><span>NAMECHEAP</span></div></th>
 	<th class="rotate"><div><span>NAMEDOTCOM</span></div></th>
 	<th class="rotate"><div><span>NS1</span></div></th>
@@ -49,6 +50,9 @@
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
+		<td class="danger">
+			<i class="fa fa-times text-danger" aria-hidden="true"></i>
+		</td>
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
@@ -91,6 +95,9 @@
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
+		<td class="danger">
+			<i class="fa fa-times text-danger" aria-hidden="true"></i>
+		</td>
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
@@ -157,6 +164,9 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td class="success">
+			<i class="fa fa-check text-success" aria-hidden="true"></i>
+		</td>
 		</tr>
 	<tr>
 		<th class="row-header" style="text-decoration: underline;" data-toggle="tooltip" data-container="body" data-placement="top" title="Provider supports some kind of ALIAS, ANAME or flattened CNAME record type">ALIAS</th>
@@ -173,6 +183,7 @@
 		</td>
 		<td><i class="fa fa-minus dim"></i></td>
 		<td><i class="fa fa-minus dim"></i></td>
+		<td><i class="fa fa-minus dim"></i></td>
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -214,6 +225,7 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td><i class="fa fa-minus dim"></i></td>
 		<td class="danger" data-toggle="tooltip" data-container="body" data-placement="top" title="The namecheap web console allows you to make SRV records, but their api does not let you read or set them">
 			<i class="fa has-tooltip fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -253,6 +265,7 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td><i class="fa fa-minus dim"></i></td>
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -288,6 +301,7 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td><i class="fa fa-minus dim"></i></td>
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -317,6 +331,7 @@
 		</td>
 		<td><i class="fa fa-minus dim"></i></td>
 		<td><i class="fa fa-minus dim"></i></td>
+		<td><i class="fa fa-minus dim"></i></td>
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -350,6 +365,9 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td class="danger">
+			<i class="fa fa-times text-danger" aria-hidden="true"></i>
+		</td>
 		<td class="danger" data-toggle="tooltip" data-container="body" data-placement="top" title="Doesn&#39;t allow control of apex NS records">
 			<i class="fa has-tooltip fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -391,6 +409,9 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td class="danger">
+			<i class="fa fa-times text-danger" aria-hidden="true"></i>
+		</td>
 		<td class="danger" data-toggle="tooltip" data-container="body" data-placement="top" title="Requires domain registered through their service">
 			<i class="fa has-tooltip fa-times text-danger" aria-hidden="true"></i>
 		</td>
@@ -436,6 +457,9 @@
 		<td class="success">
 			<i class="fa fa-check text-success" aria-hidden="true"></i>
 		</td>
+		<td class="success">
+			<i class="fa fa-check text-success" aria-hidden="true"></i>
+		</td>
 		<td class="danger">
 			<i class="fa fa-times text-danger" aria-hidden="true"></i>
 		</td>

docs/_providers/linode.md

@@ -0,0 +1,57 @@
+---
+name: Linode
+title: Linode Provider
+layout: default
+jsId: LINODE
+---
+# Linode Provider
+
+## Configuration
+In your credentials file, you must provide your
+[Linode Personal Access Token](https://cloud.linode.com/profile/tokens)
+
+{% highlight json %}
+{
+  "linode": {
+    "token": "your-linode-personal-access-token"
+  }
+}
+{% endhighlight %}
+
+## Metadata
+This provider does not recognize any special metadata fields unique to Linode.
+
+## Usage
+Example Javascript:
+
+{% highlight js %}
+var REG_NONE = NewRegistrar('none', 'NONE')
+var LINODE = NewDnsProvider("linode", "LINODE");
+
+D("example.tld", REG_NONE, DnsProvider(LINODE),
+    A("test","1.2.3.4")
+);
+{%endhighlight%}
+
+## Activation
+[Create Personal Access Token](https://cloud.linode.com/profile/tokens)
+
+## Caveats
+Linode does not allow all TTLs, but only a specific subset of TTLs. The following TTLs are supported
+([source](https://github.com/linode/manager/blob/master/src/domains/components/SelectDNSSeconds.js)):
+
+- 300
+- 3600
+- 7200
+- 14400
+- 28800
+- 57600
+- 86400
+- 172800
+- 345600
+- 604800
+- 1209600
+- 2419200
+
+The provider will automatically round up your TTL to one of these values. For example, 600 seconds would become 3600
+seconds, but 300 seconds would stay 300 seconds. 

docs/provider-list.md

@@ -63,6 +63,7 @@ Maintainers of contributed providers:
 * digital ocean @Deraen
 * dnsimple @aeden
 * gandi @TomOnTime
+* Linode @koesie10
 * namecheap @captncraig
 * ns1 @captncraig
 * OVH @masterzen
@@ -83,7 +84,6 @@ code to support this provider, please re-open the issue. We'd be glad to help in
   <li>GoDaddy (<a href="https://github.com/StackExchange/dnscontrol/issues/145">#145</a>)</li>
   <li>Hurricane Electric (dns.he.net) (<a href="https://github.com/StackExchange/dnscontrol/issues/118">#118</a>)</li>
   <li>INWX (<a href="https://github.com/StackExchange/dnscontrol/issues/254">#254</a>)</li>
-  <li>Linode (<a href="https://github.com/StackExchange/dnscontrol/issues/121">#121</a>)</li>
   <li>NameSilo (<a href="https://github.com/StackExchange/dnscontrol/issues/220">#220</a>)</li>
   <li>OVH (<a href="https://github.com/StackExchange/dnscontrol/issues/143">#143</a>)</li>
 </ul>

integrationTest/providers.json

@@ -36,6 +36,12 @@
     "private_key": "$GCLOUD_PRIVATEKEY",
     "project_id": "$GCLOUD_PROJECT"
   },
+  "LINODE": {
+    "COMMENT": "25: Linode's hostname validation does not allow the target domain TLD",
+    "token": "$LINODE_TOKEN",
+    "domain": "$LINODE_DOMAIN",
+    "knownFailures": "25"
+  },
   "NS1": {
     "domain": "$NS1_DOMAIN",
     "api_token": "$NS1_TOKEN"

providers/_all/all.go

@@ -10,6 +10,7 @@ import (
 	_ "github.com/StackExchange/dnscontrol/providers/dnsimple"
 	_ "github.com/StackExchange/dnscontrol/providers/gandi"
 	_ "github.com/StackExchange/dnscontrol/providers/gcloud"
+	_ "github.com/StackExchange/dnscontrol/providers/linode"
 	_ "github.com/StackExchange/dnscontrol/providers/namecheap"
 	_ "github.com/StackExchange/dnscontrol/providers/namedotcom"
 	_ "github.com/StackExchange/dnscontrol/providers/ns1"