neutron-lbaas/devstack
Nir Magnezi 7cd3443305 Adds neutron_lbaas.conf and services_lbaas.conf to q-svc command line
When q-lbaasv2 is enabled in local.conf, the neutron-lbaas plugin.sh
script creates new services_lbaas.conf and neutron_lbaas.conf files
with some config parameters.

Under several circumstances, some of the options in those files are
needed by other neutron daemons, such as the q-svc service.

This patch modifies the neutron-lbaas devstack plugin to include the
above mentioned config files in q-svc command line, by adding those
files to Q_PLUGIN_EXTRA_CONF_FILES.

Since both config files are shipped in neutron-lbaas, both should be
included. Starting from Ocata, The service provider option won't
automatically load to q-svc, so that is another good incentive to have
it passed with --config-file.

Closes-Bug: #1619466
Related-Bug: #1565511

Change-Id: I652ab029b7427c8783e4b2f0443a89ee884bf064
2016-09-13 11:17:33 +00:00
..
files/debs Update devstack plugin for dependent packages 2016-03-16 22:36:28 +00:00
samples Use "--pub-key" instead of "--pub_key" 2016-07-14 01:09:05 -05:00
README.md devstack: Remove q-lbaasv1 alias 2016-07-19 16:49:50 +09:00
plugin.sh Adds neutron_lbaas.conf and services_lbaas.conf to q-svc command line 2016-09-13 11:17:33 +00:00
settings Adds neutron_lbaas.conf and services_lbaas.conf to q-svc command line 2016-09-13 11:17:33 +00:00

README.md

This directory contains the neutron-lbaas devstack plugin. To configure the neutron load balancer, in the local section, you will need to enable the neutron-lbaas devstack plugin and enable the LBaaS service by editing the local section of your local.conf file.

Octavia is the LBaaS V2 reference service provider and is used in the examples below. Enabling another service provider, such as the agent Haproxy driver, can be done by enabling its driver plugin, if applicable, and setting the appropriate service provider value for NEUTRON_LBAAS_SERVICE_PROVIDERV2, like the following:

NEUTRON_LBAAS_SERVICE_PROVIDERV2="LOADBALANCERV2:Haproxy:neutron_lbaas.drivers.haproxy.plugin_driver.HaproxyOnHostPluginDriver:default"

In addition, you can enable multiple service providers by enabling the applicable driver plugins and space-delimiting the service provider values in NEUTRON_LBAAS_SERVICE_PROVIDERV2.

  1. Enable the plugins

To enable the plugin, add a line of the form:

enable_plugin neutron-lbaas <neutron-lbaas GITURL> [GITREF]
enable_plugin octavia <octavia GITURL> [GITREF]

where

<neutron-lbaas GITURL> is the URL of a neutron-lbaas repository
<octavia GITURL> is the URL of a octavia repository
[GITREF] is an optional git ref (branch/ref/tag).  The default is
         master.

For example

enable_plugin neutron-lbaas https://git.openstack.org/openstack/neutron-lbaas stable/liberty
enable_plugin octavia https://git.openstack.org/openstack/octavia stable/liberty
  1. Enable the LBaaS services

To enable the LBaaS services, add lines in the form:

ENABLED_SERVICES+=<LBAAS-FLAG>
ENABLED_SERVICES+=<OCTAVIA-FLAGS>

where

<LBAAS-FLAG> is "q-lbaas" for LBaaS Version 1, or "q-lbaasv2"
             for LBaaS Version 2.
<OCTAVIA-FLAGS> are "octavia" the Octavia driver,
                "o-cw" the Octavia Controller Worker,
                "o-hk" the Octavia housekeeping manager,
                "o-hm" the Octavia Health Manager,
                and "o-api" the Octavia API service.

to the local section of local.conf

For example

# For LBaaS V2
ENABLED_SERVICES+=,q-lbaasv2
ENABLED_SERVICES+=,octavia,o-cw,o-hk,o-hm,o-api
  1. Enable the dashboard of LBaaS V2

If using LBaaS V2 and you want to add horizon support, add lines in the form:

enable_plugin neutron-lbaas-dashboard <neutron-lbaas-dashboard GITURL> [GITREF]

where

<neutron-lbaas-dashboard GITURL> is the URL of a neutron-lbaas-dashboard repository
[GITREF] is an optional git ref (branch/ref/tag).  The default is
         master.

For example

enable_plugin neutron-lbaas-dashboard https://git.openstack.org/openstack/neutron-lbaas-dashboard stable/liberty

Once you enable the neutron-lbaas-dashboard plugin in your local.conf, ensure horizon and q-lbaasv2 services are enabled. If both of them are enabled, neutron-lbaas-dashboard will be enabled automatically

For more information, see the "Externally Hosted Plugins" section of http://docs.openstack.org/developer/devstack/plugins.html.