kops/dns-controller
Justin Santa Barbara 07dc543877 flag naming: metrics-listen-addr => metrics-listen
This follows our patterns a bit better IMO
2018-04-03 06:56:42 -07:00
..
cmd/dns-controller flag naming: metrics-listen-addr => metrics-listen 2018-04-03 06:56:42 -07:00
docs fixing up the line length 2017-06-08 11:00:33 +01:00
pkg Fix bazel deprecation notice 2018-02-26 09:36:13 -05:00
README.md Keeping this file <=72 2017-06-08 11:06:56 +01:00

README.md

dns-controller

dns-controller creates DNS records.

In the bring-up of a new cluster, protokube has already ensured that we have an etcd cluster and an apiserver. It also sets up DNS records for the etcd nodes (this is a much simpler problem, because we have a 1:1 mapping from an etcd node to a DNS name.)

However, none of the nodes can reach the api server to register. Nor can end-users reach the API. In future we might expose the API server as a normal service via Type=LoadBalancer or via a normal Ingress, but for now we just expose it via DNS.

The dns-controller recognizes annotations on nodes.

  • dns.alpha.kubernetes.io/external will set up records for accessing the resource externally
  • dns.alpha.kubernetes.io/internal will set up records for accessing the resource internally

When added on Service controllers:

  • dns.alpha.kubernetes.io/external creates a Route53 A record with public IPs of all the nodes
  • dns.alpha.kubernetes.io/internal creates a Route53 A record with private IPs of all the nodes

The syntax is a comma separated list of fully qualified domain names.