# README
Mesos-DNS

Mesos-DNS enables DNS based service discovery in Apache Mesos clusters.
Status
This project is undergoing heavy refactoring, hardening and testing and is considered alpha. We have adopted a semantic versioning scheme which clearly communicates its status and progression over time.
Compatibility
mesos-N
tags mark the start of support for a specific Mesos version while
maintaining backwards compatibility with the previous major version.
Installing
The official distribution and installation channel is pre-compiled binaries available in Github releases.
Building
Building the master branch from source should always succeed but doesn't provide the same stability and compatibility guarantees as releases.
All dependencies are vendored using Godeps
which require you to
install it in order to build from source.
$ go get github.com/tools/godep
$ godep go build ./...
Testing
$ godep go test -race ./...
Documentation
Detailed documentation on how to configure, operate and use Mesos-DNS under different scenarios and environments is available in http://mesosphere.github.io/mesos-dns/.
Contributing
Contributions are welcome. Please refer to CONTRIBUTING.md for guidelines.
Contact
For any discussion that isn't well suited for Github issues, please use our mailing list.
License
This project is Apache License 2.0.