havana configuration ref docs for nova docker driver do not clearly state net support

Bug #1243319 reported by Boden R on 2013-10-22
This bug affects 4 people
Affects Status Importance Assigned to Milestone
Stephen Gordon

Bug Description

A new nova virt driver was released in the Havana driver called docker. There is a section on configuring this driver in the config ref docs here: http://docs.openstack.org/havana/config-reference/content/docker.html

However from an admin/config perspective what is not indicated is the networking models supported with the docker driver. In particular as I understand (I'm not a docker developer) the docker driver only supports the LinuxBridge based networking. Thus if you are using the OVS plugin or something else for neutron, networking with docker will not work.

IRC chat for reference:

<boden> just to confirm what appears to be the obvious -- the openstack docker driver only supports linuxbridge networking correct? so if I'm using openstack neutron with open vswitch I'm out of luck for the docker driver
<jpetazzo> boden: that's correct; the nova driver will only support the basic networking model. however, there are 3rd party tools to integrate containers within other topologies (but those tools aren't integrated with openstack yet). you can use them but won't see proper status etc. in horizons and other openstack apis
31<boden>30 jpetazzo thanks... any plans to make the net support statement more obvious in the openstack docs (i.e. http://docs.openstack.org/havana/config-reference/content/docker.html)? its very obvious by looking at the code, but admin type folks may assume neutron support in the docker driver if not otherwise noted
<jpetazzo> boden: good idea but to be honest I have no idea how to make it happen :) /cc samalba
31<boden>30 jpetazzo -- I believe an openstack defect for doc/ID team
31<boden>30 I can do that

Tom Fifield (fifieldt) on 2013-10-23
Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → Low
milestone: none → havana
importance: Low → Medium
Stephen Gordon (sgordon) on 2014-02-01
Changed in openstack-manuals:
assignee: nobody → Stephen Gordon (sgordon)

Fix proposed to branch: master
Review: https://review.openstack.org/75520

Changed in openstack-manuals:
status: Confirmed → In Progress

Reviewed: https://review.openstack.org/75520
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=78a2be248032756a7edb31374d817b0f11c435b1
Submitter: Jenkins
Branch: master

commit 78a2be248032756a7edb31374d817b0f11c435b1
Author: Stephen Gordon <email address hidden>
Date: Fri Feb 21 16:34:21 2014 -0500

    Docker driver only supports LinuxBridge networking

    Added an admonition highlighting that the Docker driver only supports
    LinuxBridge networking.

    Change-Id: Iff14a0046350dad044c9e26fad0149571a9cb3ce
    Closes-Bug: #1243319

Changed in openstack-manuals:
status: In Progress → Fix Released

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.

To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers