README
¶
Mesos-DNS 
Mesos-DNS enables DNS based service discovery in Apache Mesos clusters.
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 branches and pull requests are tested by Circle-CI, which also outputs artifacts for Mac OS X, Windows, and Linux via cross-compilation.
You will need Go 1.5 or later to build the project.
All dependencies are vendored using Godeps. You must first install it in order to build from source.
$ go get github.com/tools/godep
$ godep go build ./...
Building for release
To do a build:
- Cut a branch
- Tag it with the relevant version, and push the tags along with the branch
- If the build doesn't trigger automatically, go here: https://circleci.com/gh/mesosphere/mesos-dns, find your branch, and trigger the build.
If you choose to do a private build:
-
Fork the repo on Github to a private repo
-
Customize that repo
-
Add it to Circle-CI
Circle-CI allows for private repositories to be kept, and built in private
-
Go to the build steps.
Releasing
- Download the artifacts from the Circle-CI builds
- Cut a release based on the tag on Github
- Upload the artifacts back to Github. Ensure you upload all the artifacts, including the .asc files.
Code signing
This repo using code signing. There is an armored, encrypted gpg key in the repo at build/private.key. This file includes the Mesos-DNS gpg signing key. The passphrase for the key is stored in Circle-CI's environment. This makes it fairly difficult to leak both components without detectable maliciousness.
There are only very few users with access to the private key, and they also have access to a revocation certificate in case the private key leaks.
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 or our public chat room.
License
This project is Apache License 2.0.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Godeps
|
|
|
_workspace/src/github.com/emicklei/go-restful
Package restful, a lean package for creating REST-style WebServices without magic.
|
Package restful, a lean package for creating REST-style WebServices without magic. |
|
_workspace/src/github.com/emicklei/go-restful/swagger
Package swagger implements the structures of the Swagger https://github.com/wordnik/swagger-spec/blob/master/versions/1.2.md
|
Package swagger implements the structures of the Swagger https://github.com/wordnik/swagger-spec/blob/master/versions/1.2.md |
|
_workspace/src/github.com/gogo/protobuf/proto
Package proto converts data structures to and from the wire format of protocol buffers.
|
Package proto converts data structures to and from the wire format of protocol buffers. |
|
_workspace/src/github.com/gogo/protobuf/proto/proto3_proto
Package proto3_proto is a generated protocol buffer package.
|
Package proto3_proto is a generated protocol buffer package. |
|
_workspace/src/github.com/golang/glog
Package glog implements logging analogous to the Google-internal C++ INFO/ERROR/V setup.
|
Package glog implements logging analogous to the Google-internal C++ INFO/ERROR/V setup. |
|
_workspace/src/github.com/kylelemons/godebug/diff
Package diff implements a linewise diff algorithm.
|
Package diff implements a linewise diff algorithm. |
|
_workspace/src/github.com/kylelemons/godebug/pretty
Package pretty pretty-prints Go structures.
|
Package pretty pretty-prints Go structures. |
|
_workspace/src/github.com/mesos/mesos-go/detector
The detector package houses implementation of master detectors.
|
The detector package houses implementation of master detectors. |
|
_workspace/src/github.com/mesos/mesos-go/detector/zoo
Zookeeper-based mesos-master leaderhip detection.
|
Zookeeper-based mesos-master leaderhip detection. |
|
_workspace/src/github.com/mesos/mesos-go/mesosproto
Package mesosproto is a generated protocol buffer package.
|
Package mesosproto is a generated protocol buffer package. |
|
_workspace/src/github.com/mesos/mesos-go/upid
Package upid defines the UPID type and some utilities of the UPID.
|
Package upid defines the UPID type and some utilities of the UPID. |
|
_workspace/src/github.com/miekg/dns
Package dns implements a full featured interface to the Domain Name System.
|
Package dns implements a full featured interface to the Domain Name System. |
|
_workspace/src/github.com/miekg/dns/idn
Package idn implements encoding from and to punycode as speficied by RFC 3492.
|
Package idn implements encoding from and to punycode as speficied by RFC 3492. |
|
_workspace/src/github.com/samuel/go-zookeeper/zk
Package zk is a native Go client library for the ZooKeeper orchestration service.
|
Package zk is a native Go client library for the ZooKeeper orchestration service. |
|
_workspace/src/github.com/stretchr/objx
objx - Go package for dealing with maps, slices, JSON and other data.
|
objx - Go package for dealing with maps, slices, JSON and other data. |
|
_workspace/src/github.com/stretchr/testify/assert
Package assert provides a set of comprehensive testing tools for use with the normal Go testing system.
|
Package assert provides a set of comprehensive testing tools for use with the normal Go testing system. |
|
_workspace/src/github.com/stretchr/testify/mock
Provides a system by which it is possible to mock your objects and verify calls are happening as expected.
|
Provides a system by which it is possible to mock your objects and verify calls are happening as expected. |
|
_workspace/src/github.com/tv42/zbase32
Package zbase32 implements the z-base-32 encoding as specified in http://philzimmermann.com/docs/human-oriented-base-32-encoding.txt Note that this is NOT RFC 4648, for that see encoding/base32.
|
Package zbase32 implements the z-base-32 encoding as specified in http://philzimmermann.com/docs/human-oriented-base-32-encoding.txt Note that this is NOT RFC 4648, for that see encoding/base32. |
|
_workspace/src/github.com/tv42/zbase32/cmd/zbase32-decode
Command zbase32-decode decodes zbase32 from arguments or lines of stdin.
|
Command zbase32-decode decodes zbase32 from arguments or lines of stdin. |
|
_workspace/src/github.com/tv42/zbase32/cmd/zbase32-encode
Command zbase32-encode encodes its standard input as zbase32.
|
Command zbase32-encode encodes its standard input as zbase32. |
|
_workspace/src/golang.org/x/net/context
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.
|
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes. |
|
_workspace/src/golang.org/x/net/context/ctxhttp
Package ctxhttp provides helper functions for performing context-aware HTTP requests.
|
Package ctxhttp provides helper functions for performing context-aware HTTP requests. |
|
Package dnstest provides DNS testing utilities and convenience functions.
|
Package dnstest provides DNS testing utilities and convenience functions. |
|
Package exchanger provides DNS exchanger decorators and other utilities.
|
Package exchanger provides DNS exchanger decorators and other utilities. |
|
Package records contains functions to generate resource records from mesos master states to serve through a dns server
|
Package records contains functions to generate resource records from mesos master states to serve through a dns server |
|
Package resolver contains functions to handle resolving .mesos domains
|
Package resolver contains functions to handle resolving .mesos domains |