Skip to content

Commit

Permalink
ovs-docker: Enhance documentation to handle pre-programmed interfaces.
Browse files Browse the repository at this point in the history
Currently, Controllers and CMSes that integrate with Open vSwitch
after following the IntegrationGuide.md, expect to start VMs after
the underlying network infrastructure is ready. I have been asked
a few times on how to handle the same with containers. This commit
provides documentation on one way to achieve it.

Signed-off-by: Gurucharan Shetty <[email protected]>
Acked-by: Thomas Graf <[email protected]>
  • Loading branch information
shettyg committed Dec 15, 2014
1 parent acf72f1 commit 7894385
Showing 1 changed file with 16 additions and 1 deletion.
17 changes: 16 additions & 1 deletion INSTALL.Docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,22 @@ and del-port[s] commands.

Once a container interface is added to an Open vSwitch bridge, one can
set VLANs, create Tunnels, add OpenFlow rules etc for more network control.
Many times, it is important that the underlying network infrastructure is
plumbed (or programmed) before the application inside the container starts.
To handle this, one can create a micro-container, attach an Open vSwitch
interface to that container, set the UUIDS in OVSDB as mentioned in
[IntegrationGuide.md] and then program the bridge to handle traffic coming out
of that container. Now, you can start the main container asking it
to share the network of the micro-container. When your application starts,
the underlying network infrastructure would be ready. e.g.:

```
% docker run -d --net=container:$MICROCONTAINER_ID ubuntu:14.04 /bin/sh -c \
"while true; do echo hello world; sleep 1; done"
```

Please read the man pages of ovs-vsctl, ovs-ofctl, ovs-vswitchd,
ovsdb-server ovs-vswitchd.conf.db etc for more details.
ovsdb-server and ovs-vswitchd.conf.db etc for more details about Open vSwitch.

Docker networking is quite flexible and can be used in multiple ways. For more
information, please read:
Expand All @@ -89,3 +103,4 @@ Bug Reporting
Please report problems to [email protected].

[INSTALL.md]:INSTALL.md
[IntegrationGuide.md]:IntegrationGuide.md

0 comments on commit 7894385

Please sign in to comment.