summaryrefslogtreecommitdiffstats
path: root/roles/dns/README.md
diff options
context:
space:
mode:
authorThomas Wiest <twiest@users.noreply.github.com>2016-02-04 16:27:31 -0500
committerThomas Wiest <twiest@users.noreply.github.com>2016-02-04 16:27:31 -0500
commitb25ad7c7462c1ead726fa998e99b12a0c4da8676 (patch)
treeaba2da336673022ed2525bbbbd6952df334b79f8 /roles/dns/README.md
parenta467f94a0157eaee88900dd466dd79dab2befa52 (diff)
parent82d474d7b1ba564f051c1ccf125413f4cca28d42 (diff)
downloadopenshift-b25ad7c7462c1ead726fa998e99b12a0c4da8676.tar.gz
openshift-b25ad7c7462c1ead726fa998e99b12a0c4da8676.tar.bz2
openshift-b25ad7c7462c1ead726fa998e99b12a0c4da8676.tar.xz
openshift-b25ad7c7462c1ead726fa998e99b12a0c4da8676.zip
Merge pull request #1206 from lhuard1A/openstack_dns
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