Skip to content
This repository has been archived by the owner on Feb 1, 2020. It is now read-only.

Commit

Permalink
more protips
Browse files Browse the repository at this point in the history
  • Loading branch information
progrium committed Jul 3, 2014
1 parent 028923e commit 0e72d97
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This project is a Docker container for [Consul](http://www.consul.io/). It's a s

## Getting the container

The container is very small (28MB virtual, based on [Busybox](https://github.com/progrium/busybox)) and available on the Docker Index:
The container is very small (26MB virtual, based on [Busybox](https://github.com/progrium/busybox)) and available on the Docker Index:

$ docker pull progrium/consul

Expand All @@ -24,7 +24,7 @@ Our recommended interface is HTTP using curl:

We can also use dig to interact with the DNS interface:

$ dig @0.0.0.0 -p 8600 node1.node.cluster
$ dig @0.0.0.0 -p 8600 node1.node.consul

However, if you install Consul on your host, you can use the CLI interact with the containerized Consul Agent:

Expand Down Expand Up @@ -159,6 +159,10 @@ You can simply wrap the cmd:run output in a subshell. Here is what you can run t

This container was designed assuming you'll be using it for DNS on your other containers. So it listens on port 53 inside the container to be more compatible and accessible via linking. It also has DNS recursive queries enabled, using the Google 8.8.8.8 nameserver.

When running with `cmd:run`, it publishes the DNS port on the Docker bridge. You can use this with the `--dns` flag in `docker run`, or better yet, use it with the Docker daemon. Here is a command you can run on Ubuntu systems that will tell Docker to use the bridge IP for DNS, otherwise use Google DNS, and use `service.consul` as the search domain.

$ echo "DOCKER_OPTS='--dns 172.17.42.1 --dns 8.8.8.8 --dns-search service.consul'" >> /etc/default/docker

#### Runtime Configuration

Although you can extend this image to add configuration files to define services and checks, this container was designed for environments where services and checks can be configured at runtime via the HTTP API.
Expand Down

0 comments on commit 0e72d97

Please sign in to comment.