Update Neutron reference docs

Add Neutron reference docs, especially a note around
using OVS native firewall driver on recent (4.3+) kernels [1].

[1]: https://docs.openstack.org/neutron/latest/admin/config-ovsfwdriver.html

Change-Id: I6994e364c116234b46f5d5e9f0a4666b83f86375
Closes-Bug: #1653987
This commit is contained in:
Michal Nasiadka 2019-09-25 14:18:09 +02:00 committed by Radosław Piliszek
parent 7d95cfd737
commit d3b41a181a
2 changed files with 60 additions and 0 deletions

View File

@ -12,6 +12,7 @@ Networking-SFC, QoS, and so on.
designate-guide
dpdk
neutron
neutron-extensions
opendaylight
provider-networks

View File

@ -0,0 +1,59 @@
.. _neutron:
============================
Neutron - Networking Service
============================
Preparation and deployment
~~~~~~~~~~~~~~~~~~~~~~~~~~
Neutron is enabled by default in ``/etc/kolla/globals.yml``:
.. code-block:: yaml
#enable_neutron: "{{ enable_openstack_core | bool }}"
Neutron external interface is used for communication with the external world,
for example provider networks and floating IPs.
For setting up the neutron external interface please modify
``/etc/kolla/globals.yml`` setting ``neutron_external_interface`` to the
desired interface name, ``eth1`` in the example below:
.. code-block:: yaml
neutron_external_interface: "eth1"
.. note::
This is used by hosts in the ``network`` group, and hosts in the ``compute``
group if ``enable_neutron_provider_networks`` is set or DVR is enabled.
To use provider networks in instances you also need to set the following in
``/etc/kolla/globals.yml``:
.. code-block:: yaml
enable_neutron_provider_networks: yes
.. note::
``enable_neutron_provider_networks`` ensures ``neutron_external_interface``
is used on hosts in the ``compute`` group.
By default ``kolla-ansible`` uses ``openvswitch`` as its underlying network
mechanism, you can change that using the ``neutron_plugin_agent`` variable in
``/etc/kolla/globals.yml``:
.. code-block:: yaml
neutron_plugin_agent: "openvswitch"
When using Open vSwitch on a compatible kernel (4.3+ upstream, consult the
documentation of your distribution for support details), you can switch
to using the native OVS firewall driver by employing a configuration override
(see :ref:`service-config`). You can set it in
``/etc/kolla/config/neutron/ml2_conf.ini``:
.. code-block:: ini
[security_group]
firewall_driver = openvswitch