commit | author | age
|
f973b9
|
1 |
# pyveth - Docker Plugin for veth networks |
JK |
2 |
|
|
3 |
Simple network plugin for Docker Engine that can replace macvlan |
|
4 |
in container-as-VM scenarios, allowing host-to-container communication |
|
5 |
(see https://github.com/docker/for-linux/issues/931 for bug details). |
|
6 |
|
|
7 |
It should be a drop-in replacement for macvlan module. |
|
8 |
|
|
9 |
## Installation |
|
10 |
|
|
11 |
Plugin is packaged as [Docker Engine-managed plugin](https://docs.docker.com/engine/extend/). |
|
12 |
|
|
13 |
To install it simply run: |
|
14 |
|
|
15 |
```bash |
|
16 |
docker plugin install jacekkow/pyveth |
|
17 |
``` |
|
18 |
|
|
19 |
## Usage |
|
20 |
|
|
21 |
After installation you can use driver in newly-created networks: |
|
22 |
|
|
23 |
```bash |
|
24 |
docker network create --driver jacekkow/pyveth:latest new-network |
|
25 |
``` |
|
26 |
|
|
27 |
By default it will simply create a pair of veth interfaces for each container. |
|
28 |
One will be pushed inside the container and another will remain on host |
|
29 |
(without any IP assigned). |
|
30 |
|
|
31 |
Plugin accepts optional `parent` parameter, which is be a name of bridge |
|
32 |
interface that the second interface should be added to: |
|
33 |
|
|
34 |
```bash |
|
35 |
docker network create --driver jacekkow/pyveth:latest --opt parent=br0 new-network |
|
36 |
``` |
|
37 |
|
|
38 |
## Manual packaging |
|
39 |
|
|
40 |
In order to test this module in development environment, you can build it |
|
41 |
by following [Docker Engine documentation](https://docs.docker.com/engine/extend/#developing-a-plugin). |
|
42 |
|
|
43 |
You can also use `package.sh` helper script which will perform |
|
44 |
all the steps (including installation) automatically. |
|
45 |
|
|
46 |
|