summaryrefslogtreecommitdiffstats
path: root/roles/dns/README.md
diff options
context:
space:
mode:
authorLénaïc Huard <lhuard@amadeus.com>2016-01-18 16:28:55 +0100
committerLénaïc Huard <lhuard@amadeus.com>2016-02-04 18:20:03 +0100
commit82d474d7b1ba564f051c1ccf125413f4cca28d42 (patch)
tree0824401bf9beb36f4e137827177e988070b51981 /roles/dns/README.md
parent73ab565d036b6f3c8777d305fdc1a5029b097f88 (diff)
downloadopenshift-82d474d7b1ba564f051c1ccf125413f4cca28d42.tar.gz
openshift-82d474d7b1ba564f051c1ccf125413f4cca28d42.tar.bz2
openshift-82d474d7b1ba564f051c1ccf125413f4cca28d42.tar.xz
openshift-82d474d7b1ba564f051c1ccf125413f4cca28d42.zip
Add a DNS server on OpenStack clusters
Diffstat (limited to 'roles/dns/README.md')
-rw-r--r--roles/dns/README.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/roles/dns/README.md b/roles/dns/README.md
new file mode 100644
index 000000000..e238fb92e
--- /dev/null
+++ b/roles/dns/README.md
@@ -0,0 +1,43 @@
+dns
+===
+
+Configure a DNS server serving IPs of all the nodes of the cluster
+
+Requirements
+------------
+
+None
+
+Role Variables
+--------------
+
+| Name | Mandatory / Optional | Description |
+|------|----------------------|-------------|
+| `dns_zones` | Mandatory | DNS zones in which we must find the hosts |
+| `dns_forwarders` | If not set, the DNS will be a recursive non-forwarding DNS server | DNS forwarders to delegate the requests for hosts outside of `dns_zones` |
+| `dns_all_hosts` | Mandatory | Exhaustive list of hosts |
+
+Dependencies
+------------
+
+None
+
+Example Playbook
+----------------
+
+ - hosts: dns_hosts
+ roles:
+ - role: dns
+ dns_forwarders: [ '8.8.8.8', '8.8.4.4' ]
+ dns_zones: [ novalocal, openstacklocal ]
+ dns_all_hosts: "{{ g_all_hosts }}"
+
+License
+-------
+
+ASL 2.0
+
+Author Information
+------------------
+
+OpenShift operations, Red Hat, Inc