moving weaveproxy docs off 'experimental-features'

This commit is contained in:
Paul Bellamy committed 2015-05-19 10:34:46 +01:00
1 parent 55d17ba3bf
commit 6fa0a9d70c
3 files changed
+16 -15

No files matched your search

+9 -1
View File
@@ -24,6 +24,7 @@ example](https://github.com/weaveworks/weave#example):
* [Fault tolerance](#fault-tolerance)
* [Automatic IP address management](#ipam)
* [Automatic discovery with WeaveDNS](#dns)
* [Proxy](#proxy)
### <a name="virtual-ethernet-switch"></a>Virtual Ethernet Switch
@@ -403,4 +404,11 @@ to enable and use this feature.
WeaveDNS is a distributed DNS service for weave networks, enabling
containers to address each other by name rather than IP address. Find
out more about weaveDNS from its [documentation](weavedns.html).
out more about WeaveDNS from its [documentation](weavedns.html).
### <a name="proxy"></a>Proxy
The weave proxy enables you to use the docker command-line utility, allowing
weave-enabled containers to be started in the foreground, and to wait for the
weave network interface before running. Find out more about the weave proxy
from its [documentation](proxy.html).
-1
View File
@@ -8,7 +8,6 @@ layout: default
* [Introduction, Installation and Example](https://github.com/weaveworks/weave#readme)
* [Getting Started Guides](http://weave.works/guides/)
* [Features](features.html)
* [Experimental features](experimental-features.html)
* [Automatic IP Address Management](ipam.html)
* [Automatic Discovery with WeaveDNS](weavedns.html)
* [Troubleshooting](troubleshooting.html)
@@ -1,20 +1,16 @@
---
title: Experimental features
title: Weave Proxy
layout: default
---
# Experimental features
* [Proxy](#proxy)
### <a name="proxy"></a>Proxy
# <a name="weave-proxy"></a>Weave Proxy
Instead of the weave command-line utility, you may prefer to use the standard
docker command-line utility to manage containers. This will allow containers to
be started in foreground mode. It will also ensure that the weave network
interface is available before running your container.
#### Setup
## Setup
To do this, while still connecting containers to the weave network, you can use
the weave proxy. We can start the proxy with
@@ -29,7 +25,7 @@ to globally adjust your `DOCKER_HOST`.
host1$ export DOCKER_HOST="tcp://host1:12375"
host1$ docker ps
#### Usage
## Usage
When containers are created via the weave proxy, their entrypoint will be
modified to wait for the weave network interface to become available. When they are
@@ -47,7 +43,7 @@ or, equivalently with
Multiple IP addresses and networks can be supplied in the WEAVE_CIDR variable by space-separating them, as in `WEAVE_CIDR=10.2.1.1/24 10.2.2.1/24`.
#### Usage with WeaveDNS
## Usage with WeaveDNS
Containers started via the proxy can be automatically configured to use WeaveDNS for name resolution. To accomplish this we need to launch the proxy with the `--with-dns` option
@@ -55,11 +51,9 @@ Containers started via the proxy can be automatically configured to use WeaveDNS
host1$ weave launch-dns 10.2.254.1/24
host1$ weave launch-proxy --with-dns
With this done, any containers launched through the proxy will use weaveDNS for name resolution. WeaveDNS is used in addition to any dns servers specified via the `--dns` option. More details on weaveDNS can be found in the [weaveDNS documentation](weavedns-readme.html).
With this done, any containers launched through the proxy will use weaveDNS for name resolution. WeaveDNS is used in addition to any dns servers specified via the `--dns` option. More details on weaveDNS can be found in the [weaveDNS documentation](weavedns.html).
More details on weaveDNS can be found in the [weaveDNS documentation](weavedns-readme.html).
#### Limitations
## Limitations
* The proxy does not currently support TLS.
* If you have a firewall, you will need to make sure port 12375 is open.