Skip to content

Commit

Permalink
Fix up some wording and links
Browse files Browse the repository at this point in the history
  • Loading branch information
bboreham committed Mar 2, 2016
1 parent bdc9eae commit 8c9937b
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 23 deletions.
File renamed without changes.
35 changes: 14 additions & 21 deletions site/features.md
Expand Up @@ -31,6 +31,8 @@ see [Using Weave Net](/site/using-weave/intro-example.md)

###<a name="virtual-ethernet-switch"></a>Virtual Ethernet Switch

Weave Net creates a virtual network that connects Docker containers
deployed across multiple hosts.
To application containers, the network established by Weave
resembles a giant Ethernet switch, where all containers are
connected and can easily access services from one another.
Expand All @@ -50,14 +52,11 @@ and [Deploying Applications to Weave Net](/site/using-weave/deploying-applicatio

Weave automatically chooses the fastest available method to
transport data between peers. The best performing of these
(the 'fastdp') offers near-native throughput and latency.
(the 'fast datapath') offers near-native throughput and latency.

Fastdp does not support encryption. If you supply a
password at `weave launch` the router falls back to a slower
`sleeve` mode that does support encryption.

For connections that traverse untrusted networks,
see [Securing Containers Across Untrusted Networks](/site/using-weave/security-untrusted-networks.md) for more details.
Fast datapath does not support encryption. For full details on configuring
Weave when you have connections that traverse untrusted networks,
see [Securing Connections Across Untrusted Networks](/site/using-weave/security-untrusted-networks.md) for more details.

See [Using Fast Datapath](/site/fastdp/using-fastdp.md) and
[How Fast Datapath Works](/site/fastdp/fastdp-how-it-works.md).
Expand All @@ -83,7 +82,7 @@ See [Using the Weave Docker API](/site/weave-docker-api/using-proxy.md)

###<a name="plugin"></a>Weave Network Docker Plugin

Weave can also be used as a Docker plugin. A Docker network
Weave can also be used as a [Docker plugin](https://docs.docker.com/engine/extend/plugins_network/). A Docker network
named `weave` is created by `weave launch`, which is used as follows:

$ docker run --net=weave -ti ubuntu
Expand All @@ -101,7 +100,7 @@ when there are network connectivity problems.
See [Using the Weave Docker Network Plugin](/site/plugin/weave-plugin-how-to.md) for more details.


###<a name="addressing"></a>IP Address Allocation (IPAM)
###<a name="addressing"></a>IP Address Management (IPAM)

Containers are automatically allocated a unique IP address. To view the addresses allocated by Weave run, `weave ps`.

Expand Down Expand Up @@ -178,8 +177,8 @@ running alongside Weave.

Weave implements encryption and security using [Daniel J. Bernstein's NaCl library](http://nacl.cr.yp.to/index.html).

For information on how to secure your Docker containers,
see [Securing Containers Across Untrusted Networks](/site/using-weave/security-untrusted-networks.md)
For information on how to secure your Docker network connections,
see [Securing Connections Across Untrusted Networks](/site/using-weave/security-untrusted-networks.md)
and for a more technical discussion on how Weave implements encryption see, [Using Encryption with Weave](/site/encryption/crypto-overview.md) and [How Weave Implements Encryption](/site/encryption/ephemeral-key.md)


Expand Down Expand Up @@ -223,21 +222,15 @@ See [Enabling Multi-Cloud networking and Multi-hop Routing](/site/using-weave/mu

###<a name="dynamic-topologies"></a>Dynamic Topologies

A network of containers across more than two hosts can be
established even when there is only partial connectivity
between the hosts.

Weave routes traffic between containers as long as
there is at least one *path* of connected hosts
between them.

See [Enabling Multi-Cloud networking and Multi-hop Routing](/site/using-weave/finding-adding-hosts-dynamically.md)
Hosts can be added to or removed from a Weave network without stopping
or reconfiguring the remaining hosts. See [Adding and Removing Hosts
Dynamically](/site/using-weave/finding-adding-hosts-dynamically.md)


###<a name="container-mobility"></a>Container Mobility

Containers can be moved between hosts without requiring any
re-configuration or, in many cases, restarts of other containers.
reconfiguration or, in many cases, restarts of other containers.
All that is required is for the migrated container to be started
with the same IP address as it was given originally.

Expand Down
2 changes: 1 addition & 1 deletion site/using-weave/deploying-applications.md
Expand Up @@ -42,7 +42,7 @@ If you are deploying an application that consists of more than one container to

###<a name="peer-connections"></a>Creating Peer Connections Between Hosts

To launch Weave on an additional host and create a peer connections by running the following:
To launch Weave on an additional host and create a peer connection, run the following:

host2$ weave launch $HOST1
host2$ eval $(weave env)
Expand Down
6 changes: 5 additions & 1 deletion site/using-weave/security-untrusted-networks.md
@@ -1,5 +1,5 @@
---
title: Securing Containers Across Untrusted Networks
title: Securing Connections Across Untrusted Networks
layout: default
---

Expand Down Expand Up @@ -28,6 +28,10 @@ To guard against dictionary attacks, the password needs to be reasonably strong

The same password must be specified for all Weave peers, by default both control and data plane traffic will then use authenticated encryption.

Fast datapath does not support encryption. If you supply a
password at `weave launch` the router falls back to a slower
`sleeve` mode that does support encryption.

If some of your peers are co-located in a trusted network (for example within the boundary of your own datacenter) you can use the `--trusted-subnets` argument to `weave launch` to selectively disable data plane encryption as an optimization.

Both peers must consider the other to be in a trusted subnet for this to take place - if they do not agree, Weave [falls back to a slower method]( /site/fastdp/using-fastdp.md) for transporting data between peers, since fast datapath does not support encryption.
Expand Down

0 comments on commit 8c9937b

Please sign in to comment.