| 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 | ||
