Merge pull request #2185 from weaveworks/change-titles
Restructure docs
This commit is contained in:
Adam Harrison committed
commit
a6b7f0a9d4
31 files changed
+90
-91
No files matched your search
+9
-12
@@ -1,10 +1,7 @@
|
||||
---
|
||||
title: Building Weave Net
|
||||
menu_order: 160
|
||||
menu_order: 120
|
||||
---
|
||||
|
||||
# Building Weave Net
|
||||
|
||||
You only need to build Weave Net if you want to work on the Weave Net codebase
|
||||
(or you just enjoy building software).
|
||||
|
||||
@@ -25,7 +22,7 @@ The weave git repository should be cloned into
|
||||
`$GOPATH/src/github.com/weaveworks/weave`, in accordance with [the go
|
||||
workspace conventions](https://golang.org/doc/code.html#Workspaces):
|
||||
|
||||
```bash
|
||||
```
|
||||
$ WEAVE=github.com/weaveworks/weave
|
||||
$ git clone https://$WEAVE $GOPATH/src/$WEAVE
|
||||
$ cd $GOPATH/src/$WEAVE
|
||||
@@ -36,7 +33,7 @@ Next install Docker if you haven't already, by following the instructions
|
||||
|
||||
Then to actually build, simply do:
|
||||
|
||||
```bash
|
||||
```
|
||||
$ make
|
||||
```
|
||||
|
||||
@@ -62,7 +59,7 @@ Vagrant to run VMs in.
|
||||
|
||||
First, check out the code:
|
||||
|
||||
```bash
|
||||
```
|
||||
$ git clone https://github.com/weaveworks/weave
|
||||
$ cd weave
|
||||
```
|
||||
@@ -78,7 +75,7 @@ The `Vagrantfile` in the top directory constructs a VM that has
|
||||
|
||||
Once you are in the working directory you can issue
|
||||
|
||||
```bash
|
||||
```
|
||||
$ vagrant up
|
||||
```
|
||||
|
||||
@@ -90,7 +87,7 @@ use git and so on in the regular filesystem.
|
||||
To build and run the code, you need to use the VM. To log in and build
|
||||
the weave image, do
|
||||
|
||||
```bash
|
||||
```
|
||||
$ vagrant ssh
|
||||
vm$ cd src/github.com/weaveworks/weave
|
||||
vm$ make
|
||||
@@ -98,7 +95,7 @@ vm$ make
|
||||
|
||||
The Docker daemon is also running in this VM, so you can then do
|
||||
|
||||
```bash
|
||||
```
|
||||
vm$ sudo ./weave launch
|
||||
vm$ sudo docker ps
|
||||
```
|
||||
@@ -108,7 +105,7 @@ and so on.
|
||||
If you are looking to just do a build and not run anything on this VM,
|
||||
you can do so with
|
||||
|
||||
```bash
|
||||
```
|
||||
$ vagrant ssh -c 'make -C src/github.com/weaveworks/weave'
|
||||
```
|
||||
|
||||
@@ -116,7 +113,7 @@ you should then find a `weave.tar.gz` container snapshot tarball in the
|
||||
top-level directory. You can use that snapshot with `docker load`
|
||||
against a different host, e.g.
|
||||
|
||||
```bash
|
||||
```
|
||||
$ export DOCKER_HOST=tcp://<HOST:PORT>
|
||||
$ docker load < weave.tar.gz
|
||||
```
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
---
|
||||
title: Using the Weave Net CNI Plugin
|
||||
title: Integrating Kubernetes via the CNI Plugin
|
||||
layout: default
|
||||
menu_order: 65
|
||||
---
|
||||
|
||||
CNI, the [_Container Network Interface_](https://github.com/appc/cni#cni---the-container-network-interface),
|
||||
+16
-16
@@ -1,23 +1,23 @@
|
||||
---
|
||||
title: Weave Net FAQ
|
||||
menu_order: 140
|
||||
title: FAQ
|
||||
menu_order: 100
|
||||
---
|
||||
|
||||
|
||||
|
||||
###Q:How do I obtain the IP of a specific container when I'm using Weave?
|
||||
**Q:How do I obtain the IP of a specific container when I'm using Weave?**
|
||||
|
||||
You can use `weave ps <container>` to see the allocated address of a container on a Weave network.
|
||||
|
||||
See [Troubleshooting Weave - List attached containers](/site/troubleshooting.md#list-attached-containers).
|
||||
|
||||
|
||||
###Q: How do I expose one of my containers to the outside world?
|
||||
**Q: How do I expose one of my containers to the outside world?**
|
||||
|
||||
Exposing a container to the outside world is described in [Exposing Services to the Outside](/site/using-weave/service-export.md).
|
||||
|
||||
|
||||
###Q: My dockerized app needs to check the request of a an application that uses a static IP. Is it possible to manually change the IP of a container?
|
||||
**Q: My dockerized app needs to check the request of a an application that uses a static IP. Is it possible to manually change the IP of a container?**
|
||||
|
||||
|
||||
You can manually change the IP of a container using [Classless Inter-Domain Routing or CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing).
|
||||
@@ -25,7 +25,7 @@ You can manually change the IP of a container using [Classless Inter-Domain Rout
|
||||
For more information, refer to [Manually Specifying the IP Address of a Container](/site/using-weave/manual-ip-address.md).
|
||||
|
||||
|
||||
###Q:Can I connect my existing 'legacy' network with a Weave container network?
|
||||
**Q:Can I connect my existing 'legacy' network with a Weave container network?**
|
||||
|
||||
Yes you can.
|
||||
|
||||
@@ -36,7 +36,7 @@ The simplest way to accomplish this would be to run Weave on the host and then r
|
||||
You can read about exposing ports in [Service Exporting](/site/using-weave/service-export.md)
|
||||
|
||||
|
||||
###Q: Why am I seeing the same IP address assigned to two different containers on different hosts?
|
||||
**Q: Why am I seeing the same IP address assigned to two different containers on different hosts?**
|
||||
|
||||
Under normal circumstances, this should never happen, but it can occur if `weave forget` and `weave rmpeer` was run on more than one host.
|
||||
|
||||
@@ -49,38 +49,38 @@ Some peers may be able to communicate their claim to the others before they run
|
||||
For more information on see [Address Allocation with IP Address Management (IPAM)](/site/ipam.md) and also, [Starting, Stopping and Removing Peers](/site/ipam/stop-remove-peers-ipam.md)
|
||||
|
||||
|
||||
###Q: What is the best practise for resetting a node that goes out of service?
|
||||
**Q: What is the best practice for resetting a node that goes out of service?**
|
||||
|
||||
When a node goes out of service, the best option is to call `weave rmpeer` on one host and then `weave forget` on all the other hosts.
|
||||
|
||||
See [Starting, Stopping and Removing Peers](/site/ipam/stop-remove-peers-ipam.md) for an indepth discussion.
|
||||
See [Starting, Stopping and Removing Peers](/site/ipam/stop-remove-peers-ipam.md) for an in-depth discussion.
|
||||
|
||||
|
||||
###Q: What about Weave's performance? Are software defined network overlays just as fast as native networking?
|
||||
**Q: What about Weave's performance? Are software defined network overlays just as fast as native networking?**
|
||||
|
||||
All virtualization techniques have some overhead, and Weave's overhead is typically around 2-3%. Unless your system is completely bottlenecked on the network, you won't notice this during normal operation.
|
||||
|
||||
Weave Net also automatically uses the fastest datapath between two hosts. When Weave Net can't use the fast datapath between two hosts, it falls back to the slower packet forwarding approach. Selecting the fastest forwarding approach is automatic, and is determined on a connection-by-connection basis. For example, a Weave network spanning two data centers might use fast datapath within the data centers, but not for the more constrained network link between them.
|
||||
|
||||
For more information about fast datapath see [How Fast Datapath Works](/site/fastdp/fastdp-how-it-works.md)
|
||||
For more information about fast datapath see [How Fast Datapath Works](/site/how-it-works/fastdp-how-it-works.md)
|
||||
|
||||
|
||||
###Q:How can I tell if Weave is using fast datapath (fastdp) or not?
|
||||
**Q:How can I tell if Weave is using fast datapath (fastdp) or not?**
|
||||
|
||||
To view whether Weave is using fastdp or not, you can run, `weave status connections`
|
||||
|
||||
For more information on this command, see [Using Fast Datapath](/site/fastdp.md)
|
||||
For more information on this command, see [Using Fast Datapath](/using-weave/fastdp.md)
|
||||
|
||||
|
||||
###Q: Does encryption work with fastdp?
|
||||
**Q: Does encryption work with fastdp?**
|
||||
|
||||
Encryption does not work with fast datapath. If you enable encryption using the `--password` option to launch Weave (or you use the `WEAVE_PASSWORD` environment variable), fast datapath will by default be disabled.
|
||||
|
||||
You can however have a mixture of fast datapath connections over trusted links, as well as, encrypted connections over untrusted links.
|
||||
|
||||
See [Using Fast Datapath](/site/fastdp.md) for more information
|
||||
See [Using Fast Datapath](/using-weave/fastdp.md) for more information
|
||||
|
||||
###Q: Can I create multiple networks where containers can communicate on one network, but are isolated from containers on other networks?
|
||||
**Q: Can I create multiple networks where containers can communicate on one network, but are isolated from containers on other networks?**
|
||||
|
||||
Yes, of course! Weave allows you to run isolated networks and still allow open communications between individual containers from those isolated networks. You can find information on how to do this in [Application Isolation](/site/using-weave/application-isolation.md)
|
||||
|
||||
|
||||
+6
-6
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Weave Features
|
||||
title: Feature Overview
|
||||
menu_order: 20
|
||||
---
|
||||
|
||||
@@ -58,8 +58,8 @@ 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.md) and
|
||||
[How Fast Datapath Works](/site/fastdp/fastdp-how-it-works.md).
|
||||
See [Using Fast Datapath](/using-weave/fastdp.md) and
|
||||
[How Fast Datapath Works](/site/how-it-works/fastdp-how-it-works.md).
|
||||
|
||||
###<a name="docker"></a>Seamless Docker Integration (Weave Docker API Proxy)
|
||||
|
||||
@@ -103,7 +103,7 @@ See [Using the Weave Docker Network Plugin](/site/plugin.md) for more details.
|
||||
|
||||
Weave can be used as a plugin to systems that support the [Container Network Interface](https://github.com/appc/cni), such as Kubernetes.
|
||||
|
||||
See [Using the Weave CNI Plugin](/site/plugin/cni-plugin-how-to.md) for more details.
|
||||
See [Using the Weave CNI Plugin](/site/cni-plugin.md) for more details.
|
||||
|
||||
|
||||
###<a name="addressing"></a>IP Address Management (IPAM)
|
||||
@@ -114,7 +114,7 @@ Instead of allowing Weave to automatically allocate addresses, an IP address and
|
||||
specified. See [How to Manually Specify IP Addresses and Subnets](/site/using-weave/manual-ip-address.md) for instructions.
|
||||
|
||||
For a discussion on how Weave Net uses IPAM, see [Automatic IP Address Management](/site/ipam.md). And also review the
|
||||
[the basics of IP addressing](/site/ip-addresses.md) for an explanation of addressing and private networks.
|
||||
[the basics of IP addressing](/how-it-works/ip-addresses.md) for an explanation of addressing and private networks.
|
||||
|
||||
|
||||
###<a name="naming-and-discovery"></a>Naming and Discovery
|
||||
@@ -181,7 +181,7 @@ running alongside Weave.
|
||||
|
||||
Weave Net 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 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.md) and [How Weave Implements Encryption](/site/encryption/implementation.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, [Weave Encryption](/how-it-works/encryption.md) and [How Weave Implements Encryption](/site/how-it-works/encryption-implementation.md).
|
||||
|
||||
|
||||
###<a name="host-network-integration"></a>Host Network Integration
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: How Weave Net Works
|
||||
title: Understanding how Weave Net Works
|
||||
layout: default
|
||||
menu_order: 100
|
||||
menu_order: 90
|
||||
---
|
||||
|
||||
|
||||
@@ -27,7 +27,7 @@ is given an IP address and netmask supplied either by the user or
|
||||
by Weave Net's IP address allocator.
|
||||
|
||||
Weave Net routes packets between containers on different hosts via two
|
||||
methods: a [fast data path](/site/fastdp.md) method, which operates
|
||||
methods: a [fast data path](/using-weave/fastdp.md) method, which operates
|
||||
entirely in kernel space, and a fallback `sleeve` method, in which
|
||||
packets destined for non-local containers are captured by the kernel
|
||||
and processed by the Weave Net router in user space, forwarded over
|
||||
@@ -47,5 +47,5 @@ first send it to peer 3:
|
||||
|
||||
**See Also**
|
||||
|
||||
* [Weave Router Sleeve Encapsulation](/site/router-topology/router-encapsulation.md)
|
||||
* [How Weave Inteprets Network Topology](/site/router-topology/network-topology.md)
|
||||
* [Weave Router Sleeve Encapsulation](/site/how-it-works/router-encapsulation.md)
|
||||
* [How Weave Inteprets Network Topology](/site/how-it-works/network-topology.md)
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
title: How Weave Net Implements Encryption
|
||||
layout: default
|
||||
menu_order: 70
|
||||
---
|
||||
|
||||
This section describes some details of Weave Net's built-in
|
||||
[encryption](/site/encryption.md):
|
||||
[encryption](/how-it-works/encryption.md):
|
||||
|
||||
* [Establishing the Ephemeral Session Key](#ephemeral-key)
|
||||
* [Key Generation](#csprng)
|
||||
@@ -145,7 +146,7 @@ follows:
|
||||
| Frame N: Captured payload | |
|
||||
+-----------------------------------+ -+
|
||||
|
||||
This is very similar to the [non-crypto encapsulation](/site/router-topology/router-encapsulation.md).
|
||||
This is very similar to the [non-crypto encapsulation](/site/how-it-works/router-encapsulation.md).
|
||||
|
||||
All of the frames on a connection are encrypted with the same
|
||||
ephemeral session key, and a nonce constructed from a message sequence
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
title: Encryption and Weave Net
|
||||
menu_order: 90
|
||||
menu_order: 60
|
||||
---
|
||||
|
||||
|
||||
Weave Net peers
|
||||
[communicate with each other over both TCP and UDP](/site/router-topology.md). This
|
||||
[communicate with each other over both TCP and UDP](/site/how-it-works.md). This
|
||||
communication
|
||||
[can be encrypted](/site/using-weave/security-untrusted-networks.md).
|
||||
|
||||
@@ -34,5 +34,5 @@ deployed.
|
||||
|
||||
**See Also**
|
||||
|
||||
* [How Weave Implements Encryption](/site/encryption/implementation.md)
|
||||
* [How Weave Implements Encryption](/site/how-it-works/encryption-implementation.md)
|
||||
* [Securing Containers Across Untrusted Networks](/site/using-weave/security-untrusted-networks.md)
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: How Fast Datapath Works
|
||||
menu_order: 10
|
||||
menu_order: 30
|
||||
---
|
||||
|
||||
|
||||
@@ -25,6 +25,6 @@ Prior to version 1.2, Weave Net used a custom encapsulation format. Fast datapat
|
||||
**See Also**
|
||||
|
||||
* [Deploying Applications to Weave](/site/using-weave/deploying-applications.md)
|
||||
* [Using Fast Datapath](/site/fastdp.md)
|
||||
* [Using Fast Datapath](/using-weave/fastdp.md)
|
||||
|
||||
|
||||
File renamed without changes.
@@ -144,7 +144,7 @@ which time the topology should have updated.
|
||||
|
||||
**See Also**
|
||||
|
||||
* [Weave Net Router Encapsulation](/site/router-topology/router-encapsulation.md)
|
||||
* [Weave Net Router Encapsulation](/site/how-it-works/router-encapsulation.md)
|
||||
|
||||
|
||||
|
||||
+2
-2
@@ -4,7 +4,7 @@ menu_order: 10
|
||||
---
|
||||
|
||||
When the Weave Net router forwards packets to peers in `sleeve` mode
|
||||
(rather than via the [fast data path](/site/fastdp.md)), the
|
||||
(rather than via the [fast data path](/using-weave/fastdp.md)), the
|
||||
encapsulation looks something like this:
|
||||
|
||||
+-----------------------------------+
|
||||
@@ -61,4 +61,4 @@ MAC discovery.
|
||||
|
||||
**See Also**
|
||||
|
||||
* [How Weave Net Inteprets Network Topology](/site/router-topology/network-topology.md)
|
||||
* [How Weave Net Inteprets Network Topology](/site/how-it-works/network-topology.md)
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -41,5 +41,5 @@ for the latest Weave AMIs and [here](http://weave.works/guides/service-discovery
|
||||
* [Features](/site/features.md)
|
||||
* [Troubleshooting](/site/troubleshooting.md)
|
||||
* [Building](/site/building.md)
|
||||
* [Using Weave with Systemd](/site/systemd.md)
|
||||
* [Using Weave with Systemd](/site/installing-weave/systemd.md)
|
||||
|
||||
File renamed without changes.
@@ -36,7 +36,7 @@ Weave Net can forward traffic between nodes, and it works even if the mesh netwo
|
||||
|
||||
Weave Net automatically chooses the fastest path between two hosts, offering near native throughput and latency, all without your intervention.
|
||||
|
||||
See [How Fast Datapath Works](/site/fastdp.md) for more information.
|
||||
See [How Fast Datapath Works](/using-weave/fastdp.md) for more information.
|
||||
|
||||
###Network Operations Friendly
|
||||
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Address Allocation with IP Address Management (IPAM)
|
||||
menu_order: 110
|
||||
title: Allocating IP Addresses
|
||||
menu_order: 70
|
||||
---
|
||||
|
||||
|
||||
|
||||
@@ -10,14 +10,14 @@ The command
|
||||
|
||||
reports on the current status of the weave router and IP allocator:
|
||||
|
||||
````
|
||||
```
|
||||
...
|
||||
Service: ipam
|
||||
Status: awaiting consensus (quorum: 2, known: 0)
|
||||
Range: 10.32.0.0-10.47.255.255
|
||||
DefaultSubnet: 10.32.0.0/12
|
||||
...
|
||||
````
|
||||
```
|
||||
|
||||
The first section covers the router; see the [troubleshooting
|
||||
guide](/site/troubleshooting.md#weave-status) for full details.
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Using the Weave Net Docker Network Plugin
|
||||
menu_order: 80
|
||||
title: Integrating Docker via the Network Plugin
|
||||
menu_order: 60
|
||||
---
|
||||
|
||||
|
||||
|
||||
+11
-11
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Troubleshooting Weave Net
|
||||
menu_order: 150
|
||||
menu_order: 110
|
||||
---
|
||||
|
||||
|
||||
@@ -45,7 +45,7 @@ capture and analysis tools, such as tcpdump and wireshark, to the
|
||||
|
||||
A status summary can be obtained using `weave status`:
|
||||
|
||||
````
|
||||
```
|
||||
$ weave status
|
||||
|
||||
Version: 1.1.0 (up to date; next check at 2016/04/06 12:30:00)
|
||||
@@ -75,10 +75,10 @@ $ weave status
|
||||
|
||||
Service: plugin
|
||||
DriverName: weave
|
||||
````
|
||||
```
|
||||
|
||||
The terms used here are explained further at
|
||||
[How Weave Net Works](/site/router-topology.md).
|
||||
[How Weave Net Works](/site/how-it-works.md).
|
||||
|
||||
* **Version** - shows the Weave Net version. If checkpoint is enabled (i.e.
|
||||
`CHECKPOINT_DISABLE` is not set), information about existence of a new version
|
||||
@@ -94,7 +94,7 @@ can be overridden by using the `--nickname` argument at `weave
|
||||
launch`.
|
||||
|
||||
* **Encryption** - indicates whether
|
||||
[encryption](/site/encryption.md) is in use for communication
|
||||
[encryption](/how-it-works/encryption.md) is in use for communication
|
||||
between peers.
|
||||
|
||||
* **PeerDiscovery** - indicates whether
|
||||
@@ -129,14 +129,14 @@ exponential back-off.
|
||||
|
||||
To view detailed information on the local Weave Net router's type `weave status connections`:
|
||||
|
||||
````
|
||||
```
|
||||
$ weave status connections
|
||||
<- 192.168.48.12:33866 established unencrypted fastdp 7e:21:4a:70:2f:45(host2)
|
||||
<- 192.168.48.13:60773 pending encrypted fastdp 7e:ae:cd:d5:23:8d(host3)
|
||||
-> 192.168.48.14:6783 retrying dial tcp4 192.168.48.14:6783: no route to host
|
||||
-> 192.168.48.15:6783 failed dial tcp4 192.168.48.15:6783: no route to host, retry: 2015-08-06 18:55:38.246910357 +0000 UTC
|
||||
-> 192.168.48.16:6783 connecting
|
||||
````
|
||||
```
|
||||
|
||||
The columns are as follows:
|
||||
|
||||
@@ -160,7 +160,7 @@ The columns are as follows:
|
||||
Detailed information on peers can be obtained with `weave status
|
||||
peers`:
|
||||
|
||||
````
|
||||
```
|
||||
$ weave status peers
|
||||
ce:31:e0:06:45:1a(host1)
|
||||
<- 192.168.48.12:39634 ea:2d:b2:e6:e4:f5(host2) established
|
||||
@@ -171,7 +171,7 @@ ea:2d:b2:e6:e4:f5(host2)
|
||||
ee:38:33:a7:d9:71(host3)
|
||||
-> 192.168.48.12:6783 ea:2d:b2:e6:e4:f5(host2) established
|
||||
-> 192.168.48.11:6783 ce:31:e0:06:45:1a(host1) established
|
||||
````
|
||||
```
|
||||
|
||||
This lists all peers known to this router, including itself. Each
|
||||
peer is shown with its name and nickname, then each line thereafter
|
||||
@@ -185,7 +185,7 @@ the `host3` end of the same connection as `192.168.48.13:49619`.
|
||||
Detailed information on DNS registrations can be obtained with `weave
|
||||
status dns`:
|
||||
|
||||
````
|
||||
```
|
||||
$ weave status dns
|
||||
one 10.32.0.1 eebd81120ee4 4a:0f:f6:ec:1c:93
|
||||
one 10.43.255.255 4fcec78d2a9b 66:c4:47:c6:65:bf
|
||||
@@ -196,7 +196,7 @@ three 10.40.0.2 8a9c2e2ef00f ba:98:d0:37:4f:1c
|
||||
two 10.32.0.2 83689b8f34e0 4a:0f:f6:ec:1c:93
|
||||
two 10.44.0.0 7edc306cb668 66:c4:47:c6:65:bf
|
||||
two 10.40.0.1 68a5e9c2641b ba:98:d0:37:4f:1c
|
||||
````
|
||||
```
|
||||
|
||||
The columns are as follows:
|
||||
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Using Weave Net - Example
|
||||
title: Using Weave Net
|
||||
menu_order: 40
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Configuring Weave to Explicitly Use an IP Range
|
||||
menu_order: 10
|
||||
menu_order: 15
|
||||
---
|
||||
|
||||
The default configurations for both Weave Net and Docker use [Private
|
||||
@@ -39,4 +39,4 @@ Networks](https://en.wikipedia.org/wiki/Private_network). For example
|
||||
|
||||
**See Also**
|
||||
|
||||
* [IP Addresses, Routes and Networks](/site/ip-addresses.md)
|
||||
* [IP Addresses, Routes and Networks](/how-it-works/ip-addresses.md)
|
||||
@@ -108,5 +108,5 @@ Weave Net supports *any* protocol, and it doesn't have to be over TCP/IP. For ex
|
||||
**See Also**
|
||||
|
||||
* [Installing Weave Net](/site/installing-weave.md)
|
||||
* [Using Fastdp With Weave Net](/site/fastdp.md)
|
||||
* [Using Fastdp With Weave Net](/using-weave/fastdp.md)
|
||||
* [Using the Weave Net Docker Network Plugin](/site/plugin.md)
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Using Fast Datapath
|
||||
menu_order: 70
|
||||
menu_order: 96
|
||||
---
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@ The most important thing to know about fast datapath is that you don't need to c
|
||||
|
||||
When Weave Net cannot use the fast data path between two hosts, it falls back to a slower packet forwarding approach called `sleeve`. Selecting the fastest forwarding approach is automatic, and is determined on a connection-by-connection basis. For example, a Weave network spanning two data centers might use fast data path within the data centers, but not for the more constrained network link between them.
|
||||
|
||||
See [How Fastdp Works](/site/fastdp/fastdp-how-it-works.md) for a more in-depth discussion of this feature.
|
||||
See [How Fastdp Works](/site/how-it-works/fastdp-how-it-works.md) for a more in-depth discussion of this feature.
|
||||
|
||||
###Disabling Fast Datapath
|
||||
|
||||
@@ -45,5 +45,5 @@ Where fastdp indicates that fast datapath is being used on a connection. If fast
|
||||
**See Also**
|
||||
|
||||
* [Deploying Applications to Weave](/site/using-weave/deploying-applications.md)
|
||||
* [How Fastdp Works](/site/fastdp/fastdp-how-it-works.md)
|
||||
* [How Fastdp Works](/site/how-it-works/fastdp-how-it-works.md)
|
||||
|
||||
@@ -10,7 +10,7 @@ Containers are automatically allocated an IP address that is unique across the W
|
||||
|
||||
Weave Net detects when a container has exited and releases its allocated addresses so they can be re-used by the network.
|
||||
|
||||
See the [Automatic IP Address Management](/site/ipam.md) and also an explanation of [the basics of IP addressing](/site/ip-addresses.md) for further details.
|
||||
See the [Automatic IP Address Management](/site/ipam.md) and also an explanation of [the basics of IP addressing](/how-it-works/ip-addresses.md) for further details.
|
||||
|
||||
Instead of allowing Weave Net to allocate IP addresses automatically (using IPAM), there may be instances where you need to control a particular container or a cluster by setting an IP address for it.
|
||||
|
||||
@@ -52,6 +52,6 @@ Individual IP addresses given to containers must, of course, be unique. If you p
|
||||
**See Also**
|
||||
|
||||
* [Managing Services: Exporting, Importing, Binding and Routing](/site/using-weave/service-management.md)
|
||||
* [Configuring Weave to Explicitly Use an IP Range](/site/ip-addresses/configuring-weave.md)
|
||||
* [Configuring Weave to Explicitly Use an IP Range](/site/using-weave/configuring-weave.md)
|
||||
* [Automatic IP Address Management](/site/ipam.md)
|
||||
|
||||
@@ -34,7 +34,7 @@ password at `weave launch` the router falls back to a slower
|
||||
|
||||
If some of your peers are co-located in a trusted network (for example within the boundary of your own data center) you can use the `--trusted-subnets` argument to `weave launch` to selectively disable data plane encryption as an optimization.
|
||||
|
||||
>**Note:** Both peers must consider the other to be in a trusted subnet for this to take place - if they do not agree, Weave Net [falls back to a slower method](/site/fastdp.md) for transporting data between peers, since fast datapath does not support encryption.
|
||||
>**Note:** Both peers must consider the other to be in a trusted subnet for this to take place - if they do not agree, Weave Net [falls back to a slower method](/using-weave/fastdp.md) for transporting data between peers, since fast datapath does not support encryption.
|
||||
|
||||
Be aware that:
|
||||
|
||||
@@ -45,5 +45,5 @@ Be aware that:
|
||||
|
||||
**See Also**
|
||||
|
||||
* [Using Encryption With Weave Net](/site/encryption.md)
|
||||
* [Using Fast Datapath](/site/fastdp.md)
|
||||
* [Weave Encryption](/how-it-works/encryption.md)
|
||||
* [Using Fast Datapath](/using-weave/fastdp.md)
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Setting Up The Weave Net Docker API Proxy
|
||||
menu_order: 60
|
||||
title: Integrating Docker via the API Proxy
|
||||
menu_order: 50
|
||||
---
|
||||
|
||||
|
||||
|
||||
@@ -10,12 +10,12 @@ The command
|
||||
reports on the current status of various Weave Net components, including
|
||||
the proxy, if it is running:
|
||||
|
||||
````
|
||||
```
|
||||
...
|
||||
Service: proxy
|
||||
Address: tcp://127.0.0.1:12375
|
||||
...
|
||||
````
|
||||
```
|
||||
|
||||
Information on the operation of the proxy can be obtained from the
|
||||
weaveproxy container logs using:
|
||||
|
||||
+4
-4
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Using WeaveDNS
|
||||
menu_order: 120
|
||||
title: Discovering Containers with WeaveDNS
|
||||
menu_order: 80
|
||||
---
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ it works across hosts.
|
||||
WeaveDNS is deployed as an embedded service within the Weave router.
|
||||
The service is automatically started when the router is launched:
|
||||
|
||||
```bash
|
||||
```
|
||||
host1$ weave launch
|
||||
host1$ eval $(weave env)
|
||||
```
|
||||
@@ -26,7 +26,7 @@ running when they are started. They use it for name
|
||||
resolution, and will register themselves if they either have a
|
||||
hostname in the weaveDNS domain (`weave.local` by default) or are given an explicit container name:
|
||||
|
||||
```bash
|
||||
```
|
||||
host1$ docker run -dti --name=pingme ubuntu
|
||||
host1$ docker run -ti --hostname=ubuntu.weave.local ubuntu
|
||||
root@ubuntu:/# ping pingme
|
||||
|
||||
@@ -15,7 +15,7 @@ The command:
|
||||
reports on the current status of various Weave Net components, including
|
||||
DNS:
|
||||
|
||||
````
|
||||
```
|
||||
...
|
||||
Service: dns
|
||||
Domain: weave.local.
|
||||
@@ -23,7 +23,7 @@ DNS:
|
||||
TTL: 1
|
||||
Entries: 9
|
||||
...
|
||||
````
|
||||
```
|
||||
|
||||
The first section covers the router; see the [troubleshooting
|
||||
guide](/site/troubleshooting.md#weave-status) for more details.
|
||||
|
||||
Reference in new issue
Block a user