provider/powerdns: Add site documentation

website/source/assets/stylesheets/_docs.scss

@@ -26,6 +26,7 @@ body.layout-mysql,
 body.layout-openstack,
 body.layout-packet,
 body.layout-postgresql,
+body.layout-powerdns,
 body.layout-rundeck,
 body.layout-statuscake,
 body.layout-template,

website/source/docs/providers/powerdns/index.html.markdown

@@ -0,0 +1,36 @@
+---
+layout: "powerdns"
+page_title: "Provider: PowerDNS"
+sidebar_current: "docs-powerdns-index"
+description: |-
+ The PowerDNS provider is used manipulate DNS records supported by PowerDNS server. The provider needs to be configured with the proper credentials before it can be used.
+---
+
+# PowerDNS Provider
+
+The PowerDNS provider is used manipulate DNS records supported by PowerDNS server. The provider needs to be configured
+with the proper credentials before it can be used.
+
+Use the navigation to the left to read about the available resources.
+
+## Example Usage
+
+```
+# Configure the PowerDNS provider
+provider "powerdns" {
+ api_key = "${var.pdns_api_key}"
+ server_url = "${var.pdns_server_url}"
+}
+
+# Create a record
+resource "powerdns_record" "www" {
+ ...
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `api_key` - (Required) The PowerDNS API key. This can also be specified with `PDNS_API_KEY` environment variable.
+* `server_url` - (Required) The address of PowerDNS server. This can also be specified with `PDNS_SERVER_URL` environment variable.

website/source/docs/providers/powerdns/r/record.html.markdown

@@ -0,0 +1,35 @@
+---
+layout: "powerdns"
+page_title: "PowerDNS: powerdns_record"
+sidebar_current: "docs-powerdns-resource-record"
+description: |-
+ Provides a PowerDNS record resource.
+---
+
+# powerdns\_record
+
+Provides a PowerDNS record resource.
+
+## Example Usage
+
+```
+# Add a record to the zone
+resource "powerdns_record" "foobar" {
+ zone = "example.com"
+ name = "www.example.com"
+ type = "A"
+ ttl = 300
+ records = ["192.168.0.11"]
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `zone` - (Required) The name of zone to contain this record.
+* `name` - (Required) The name of the record.
+* `type` - (Required) The record type.
+* `ttl` - (Required) The TTL of the record.
+* `records` - (Required) A string list of records.
+

website/source/layouts/docs.erb

@@ -201,6 +201,10 @@
  <a href="/docs/providers/postgresql/index.html">PostgreSQL</a>
  </li>
 
+ <li<%= sidebar_current("docs-providers-powerdns") %>>
+ <a href="/docs/providers/powerdns/index.html">PowerDNS</a>
+ </li>
+
  <li<%= sidebar_current("docs-providers-rundeck") %>>
  <a href="/docs/providers/rundeck/index.html">Rundeck</a>
  </li>

website/source/layouts/powerdns.erb

@@ -0,0 +1,26 @@
+<% wrap_layout :inner do %>
+ <% content_for :sidebar do %>
+ <div class="docs-sidebar hidden-print affix-top" role="complementary">
+ <ul class="nav docs-sidenav">
+ <li<%= sidebar_current("docs-home") %>>
+ <a href="/docs/providers/index.html">&laquo; Documentation Home</a>
+ </li>
+
+ <li<%= sidebar_current("docs-powerdns-index") %>>
+ <a href="/docs/providers/powerdns/index.html">PowerDNS Provider</a>
+ </li>
+
+ <li<%= sidebar_current(/^docs-powerdns-resource/) %>>
+ <a href="#">Resources</a>
+ <ul class="nav nav-visible">
+ <li<%= sidebar_current("docs-powerdns-resource-record") %>>
+ <a href="/docs/providers/powerdns/r/record.html">powerdns_record</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ </div>
+ <% end %>
+
+ <%= yield %>
+ <% end %>