README.md

@@ -57,6 +57,37 @@

Disable assignment of IPv6 gateway IP.

`gw4=IP`

`gw6=IP`

Forces assignment of a specified gateway (only if one is not provided by the IPAM module)
when creating the interface. Useful for [pyipam](https://github.com/jacekkow/docker-plugin-pyipam)
with `ptp=1` option and `nogw=1`/`nogw4=1`/`nogw6=1` here.

Using these would add routes like:
```
default via IP dev eth0
IP dev eth0 scope link
```

## Container creation options

To use these options add `--network name=network_name,driver-opt=option=value,driver-opt=option=value`
to the `docker run` invocation:

```bash
docker run -i -t --rm --network name=test,ip=192.168.1.1,driver-opt=gw4=192.168.0.1,driver-opt=gw6=fe80:: alpine
```

Available options:

`gw4=IP`

`gw6=IP`

Overrides network-level gw4/gw6 options.

## Manual packaging

In order to test this module in development environment, you can build it

 lib/NetworkDriver.py

@@ -37,7 +37,7 @@
        ip.link('set', index=idx, state='up')
        if 'parent' in network.Options:
            id_parent = ip.link_lookup(ifname=network.Options['parent'])[0]
            print(ip.link("set", index=idx, master=id_parent))
            ip.link("set", index=idx, master=id_parent)
        endpoint.Interface.Peer = ifname1

    return ifname0, ifname1
@@ -157,11 +157,26 @@
            'SrcName': interface,
            'DstPrefix': 'eth',
        },
        'StaticRoutes': [],
    }
    if gw4 is not None:
        result['Gateway'] = gw4.ip.compressed
    if gw6 is not None:
        result['GatewayIPv6'] = gw6.ip.compressed
    gw4 = endpoint.Options.get("gw4", network.Options.get("gw4", None))
    if gw4 is not None:
        result['StaticRoutes'].append({
            'Destination': gw4 + '/32',
            'RouteType': 1,
        })
        result['Gateway'] = gw4
    gw6 = endpoint.Options.get("gw6", network.Options.get("gw6", None))
    if gw6 is not None:
        result['StaticRoutes'].append({
            'Destination': gw6 + '/128',
            'RouteType': 1,
        })
        result['GatewayIPv6'] = gw6
    return result



 test_integration.sh

@@ -193,3 +193,61 @@
fi

docker network rm test2


###############
# Test gw4/gw6

docker network create \
  --internal \
  --driver "${PLUGIN}" \
  --opt nogw=1 \
  --opt gw4=192.168.254.1 \
  --ipam-driver jacekkow/pyipam:latest \
  --ipam-opt ptp=1 \
  --ipv6 \
  --subnet 192.168.255.0/24 \
  --subnet 2001:db8::/32 \
  test2

ADDRESSES=$(docker run --rm --network test2 \
  alpine \
  /sbin/ip addr show
)
if ! echo "${ADDRESSES}" | grep 192.168.255.0/32; then
    echo "ERROR: invalid PtP address assigned"
    exit 1
fi
if ! echo "${ADDRESSES}" | grep 2001:db8::/128; then
    echo "ERROR: invalid PtP address assigned"
    exit 1
fi

ROUTES=$(docker run --rm --network test2 \
  alpine \
  /sbin/ip route show
)
if ! echo "${ROUTES}" | grep "via 192.168.254.1"; then
    echo "ERROR: IPv4 route not assigned with gw4=..."
    exit 1
fi

ROUTES=$(docker run --rm --network test2 \
  alpine \
  /sbin/ip -6 route show
)
if echo "${ROUTES}" | grep default; then
    echo "ERROR: IPv6 route assigned with nogw=1"
    exit 1
fi

ROUTES=$(docker run --rm --network name=test2,driver-opt=gw6=fe80::1 \
  alpine \
  /sbin/ip -6 route show
)
if ! echo "${ROUTES}" | grep "via fe80::1"; then
    echo "ERROR: IPv6 route not assigned with per-container gw6=..."
    exit 1
fi

docker network rm test2