kube2sky

README

kube2sky

==============

A bridge between Kubernetes and SkyDNS. This will watch the kubernetes API for changes in Services and then publish those changes to SkyDNS through etcd.

For now, this is expected to be run in a pod alongside the etcd and SkyDNS containers.

Namespaces

Kubernetes namespaces become another level of the DNS hierarchy. See the description of -domain below.

Flags

-domain: Set the domain under which all DNS names will be hosted. For example, if this is set to kubernetes.io, then a service named "nifty" in the "default" namespace would be exposed through DNS as "nifty.default.svc.kubernetes.io".

-v: Set logging level

-etcd-mutation-timeout: For how long the application will keep retrying etcd mutation (insertion or removal of a dns entry) before giving up and crashing.

-etcd-server: The etcd server that is being used by skydns.

-kube-master-url: URL of kubernetes master. Required if --kubecfg_file is not set.

-kubecfg-file: Path to kubecfg file that contains the master URL and tokens to authenticate with the master.

-log-dir: If non empty, write log files in this directory

-logtostderr: Logs to stderr instead of files

Documentation

Overview

kube2sky is a bridge between Kubernetes and SkyDNS. It watches the Kubernetes master for changes in Services and manifests them into etcd for SkyDNS to serve as DNS records.