| commit | author | age | ||
| 659253 | 1 | # pyIPAM - Docker Plugin for IPAM |
| JK | 2 | |
| 3 | Simple IPAM plugin for Docker Engine that correctly handles IPv6 addresses | |
| 4 | (see https://github.com/docker/for-linux/issues/931 for bug details). | |
| 5 | ||
| 6 | It should be a drop-in replacement for "default" IPAM module. | |
| 7 | ||
| 8 | ## Installation | |
| 9 | ||
| 10 | Plugin is packaged as [Docker Engine-managed plugin](https://docs.docker.com/engine/extend/). | |
| 11 | ||
| 12 | To install it simply run: | |
| 13 | ||
| 14 | ```bash | |
| 15 | docker plugin install jacekkow/pyipam | |
| 16 | ``` | |
| 17 | ||
| 18 | Then you can use it in newly-created networks: | |
| 19 | ||
| 20 | ```bash | |
| a007ff | 21 | docker network create --ipam-driver jacekkow/pyipam:latest new-network |
| 659253 | 22 | ``` |
| JK | 23 | |
| 24 | Check out [`test_integration.sh`](test_integration.sh) for more examples. | |
| 25 | ||
| 26 | ## Manual packaging | |
| 27 | ||
| 28 | In order to test this module in development environment, you can build it | |
| 29 | by following [Docker Engine documentation](https://docs.docker.com/engine/extend/#developing-a-plugin). | |
| 30 | ||
| 31 | You can also use `package.sh` helper script which will perform | |
| 32 | all the steps (including installation) automatically. | |
| 33 | ||
| 34 | ||
