From cbcfcf5dab058cc6537640a554748cf37649e1d9 Mon Sep 17 00:00:00 2001
From: Dennis Dmitriev <ddmitriev@mirantis.com>
Date: Tue, 7 Mar 2017 13:26:17 +0200
Subject: [PATCH] Example for libvirt networks based on existing bridges
 (docstring)

Change-Id: I40f839e74a8d366841c3a3a5f66f91639e8b43f8
---
 devops/driver/libvirt/libvirt_driver.py | 27 +++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/devops/driver/libvirt/libvirt_driver.py b/devops/driver/libvirt/libvirt_driver.py
index 6347d02f..28b56a2d 100644
--- a/devops/driver/libvirt/libvirt_driver.py
+++ b/devops/driver/libvirt/libvirt_driver.py
@@ -396,8 +396,8 @@ class LibvirtL2NetworkDevice(network.L2NetworkDevice):
                              # to include virbrNN@200 to the current network
                              # device (linux bridge).
 
-       Template example
-       ----------------
+       Template example for NATed networks
+       -----------------------------------
        # Nodes should have at least two interfaces connected to the following
        # L2 networks:
        # admin: for admin/PXE network
@@ -489,6 +489,29 @@ class LibvirtL2NetworkDevice(network.L2NetworkDevice):
              l2_net_dev: openstack_br
              tag: 103
 
+       Template example for existing bridges
+       -------------------------------------
+
+       l2_network_devices:  # Libvirt bridges. It is *NOT* Nailgun networks
+         admin:
+           forward:
+             mode: bridge
+           parent_iface:
+             phys_dev: !os_env BAREMETAL_ADMIN_IFACE
+
+         public:
+           forward:
+             mode: bridge
+           parent_iface:
+             phys_dev: !os_env BAREMETAL_PUBLIC_IFACE
+
+         private:
+           forward:
+             mode: bridge
+           parent_iface:
+             phys_dev: !os_env BAREMETAL_PRIVATE_IFACE
+
+
     Note: This class is imported as L2NetworkDevice at .__init__.py
     """
     uuid = base.ParamField()