Skip to content

Examples

Jump to bottom
Tomofumi Hayashi edited this page Jul 25, 2017 · 10 revisions

Examples

koko runs at container hosts (not inside container), create interface (vxlan or veth) and put it in container namespace. koko supports following scenarios.

Inside one container host (with veth)

Docker <-> Docker

connect between docker containers with veth

Commands

# Config veth for Docker containers
./koko -d <container>,<linkname>[,<ipaddr>/<prefixlen>] \
       -d <container>,<linkname>[,<ipaddr>/<prefixlen>]

<container>: Docker's container identifier (CONTAINER ID or name)
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)

netns <-> netns

connect between netns containers with veth

Commands

# Config veth for netns
./koko -n <netns name>,<linkname>[,<ipaddr>/<prefixlen>] \
       -n <netns name>,<linkname>[,<ipaddr>/<prefixlen>]

<netns name>: netns name that is given by 'ip netns' command
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)

Docker <-> netns

connect between docker container and netns container with veth

Commands

# Config veth for Docker containers
./koko -d <container>,<linkname>[,<ipaddr>/<prefixlen>] \
       -n <netns name>,<linkname>[,<ipaddr>/<prefixlen>]

<container>: Docker's container identifier (CONTAINER ID or name)
<linkname>: veth link name
<netns name>: netns name that is given by 'ip netns' command
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)

Across container hosts (with vxlan)

Docker <-> vxlan

connect between docker containers with vxlan

Commands

Following commands must be executed both container hosts to connect between two containers.

# Config vxlan for Docker container
./koko -d <container>,<linkname>[,<ipaddr>/<prefixlen>] \
       -x <parent IF>,<remote IP>,<vxlan id>

<container>: Docker's container identifier (CONTAINER ID or name)
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)
<parent IF>: Egress IF name for vxlan (e.g. eth0)
<remote IP>: Unicast destination IP address for endpoint
<vxlan id>: vxlan id

netns <-> vxlan

connect between netns containers with vxlan

Commands

Following commands must be executed both container hosts to connect between two containers.

# Config vxlan with IPv4 addr for netns
./koko -n <netns name>,<linkname>[,<ipaddr>/<prefixlen>] \
       -x <parent IF>,<remote IP>,<vxlan id>

<netns name>: netns name that is given by 'ip netns' command
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)
<parent IF>: Egress IF name for vxlan (e.g. eth0)
<remote IP>: Unicast destination IP address for endpoint
<vxlan id>: vxlan id

Docker <-> netns

connect between docker container and netns container with vxlan

Commands

For each container hosts, execute koko with above (Docker<->vxlan and netns<->vxlan)

Across container hosts (with VLAN)

Docker <-> VLAN

docker containers with vlan interface

Commands

This command creates VLAN interface of physical interface then connect to given container.

# Config vxlan for Docker container
./koko -d <container>,<linkname>[,<ipaddr>/<prefixlen>] \
       -V <parent IF>,<vlan id>

<container>: Docker's container identifier (CONTAINER ID or name)
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)
<parent IF>: Egress IF name for vxlan (e.g. eth0)
<vxlan id>: vlan id

netns <-> VLAN

netns containers with vlan interface

Commands

This command creates VLAN interface of physical interface then connect to given container.

# Config vxlan with IPv4 addr for netns
./koko -n <netns name>,<linkname>[,<ipaddr>/<prefixlen>] \
       -V <parent IF>,<vlan id>

<netns name>: netns name that is given by 'ip netns' command
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)
<parent IF>: Egress IF name for vxlan (e.g. eth0)
<vlan id>: vxlan id

Across container hosts (with macvlan)

Docker <-> macvlan

Commands

This command creates macvlan interface of physical interface then connect to given container.

# Config vxlan for Docker container
./koko -d <container>,<linkname>[,<ipaddr>/<prefixlen>] \
       -M <parent IF>,<macvlan mode>

<container>: Docker's container identifier (CONTAINER ID or name)
<linkname>: veth link name
(optional) <ipaddr>/<prefixlen>: IPv4/v6 address with netmask,
                                 separated with comma
				 (e.g. `192.0.0.1/24`, `2001:DB8::1/64`
				  or `192.0.0.1/24,2001:DB8::1/64`)
<parent IF>: Egress IF name for vxlan (e.g. eth0)
<macvlan mode>: {default|private|vepa|bridge|passthru}
Clone this wiki locally