docker-plugin-hostnic is a docker network plugin which can binding a special host nic to a container.
-
Make sure you are using Docker 1.9 or later (test with 1.12)
-
Build docker-plugin-hostnic and run, or directly run docker-plugin-hostnic docker image.
docker pull qingcloud/docker-plugin-hostnic
docker run -v /run/docker/plugins:/run/docker/plugins -v /etc/docker/hostnic:/etc/docker/hostnic --network host --privileged qingcloud/docker-plugin-hostnic docker-plugin-hostnic
-
Create hostnic network，the subnet and gateway argument should be same as hostnic.
docker network create -d hostnic --subnet=192.168.1.0/24 --gateway 192.168.1.1 hostnic
-
Run a container and binding a special hostnic. Mac-address argument is for identity the hostnic. Please ensure that the ip argument do not conflict with other hostnic.
docker run -it --ip 192.168.1.5 --mac-address 52:54:0e:e5:00:f7 --network hostnic ubuntu:14.04 bash
- If the ip argument is not passed when running container, docker will assign a ip to the container, so please pass the ip argument and ensure that the ip do not conflict with other hostnic.
- Network config will save to /etc/docker/hostnic/config.json，if plugin container removed and create again, network config can recover from the config.
- If your host only have one nic, please not use this plugin. If you binding the only one nic to container, your host will lost network.