Neutron Gateway

  • By OpenStack Charmers
  • Cloud
Channel Revision Published Runs on
latest/edge 545 22 Jun 2024
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 544 22 Jun 2024
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 543 22 Jun 2024
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 542 22 Jun 2024
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 540 29 May 2024
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 536 14 Nov 2023
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 532 14 Jul 2023
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 508 10 May 2022
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 255 17 Dec 2020
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
latest/edge 2 17 Dec 2020
Ubuntu 24.04 Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04 Ubuntu 20.04 Ubuntu 14.04 Ubuntu 12.04
yoga/stable 533 26 Jul 2023
Ubuntu 22.04 Ubuntu 20.04
zed/stable 525 20 Feb 2023
Ubuntu 22.10 Ubuntu 22.04
xena/stable 509 05 Aug 2022
Ubuntu 20.04
wallaby/stable 512 23 Jan 2023
Ubuntu 20.04
victoria/stable 524 26 Jan 2023
Ubuntu 20.04
ussuri/stable 522 26 Jan 2023
Ubuntu 20.04 Ubuntu 18.04
train/candidate 518 28 Nov 2022
Ubuntu 18.04
train/edge 523 26 Jan 2023
Ubuntu 18.04
stein/candidate 518 28 Nov 2022
Ubuntu 18.04
stein/edge 523 26 Jan 2023
Ubuntu 18.04
rocky/candidate 518 28 Nov 2022
Ubuntu 18.04
rocky/edge 523 26 Jan 2023
Ubuntu 18.04
queens/candidate 518 28 Nov 2022
Ubuntu 18.04
queens/edge 523 26 Jan 2023
Ubuntu 18.04
2024.1/candidate 539 24 May 2024
Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.04
2024.1/candidate 536 24 Jan 2024
Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.04
2023.2/stable 535 30 Nov 2023
Ubuntu 23.10 Ubuntu 22.04
2023.1/stable 531 14 Jun 2023
Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04
juju deploy neutron-gateway --channel yoga/stable
Show information

Platform:

Ubuntu
24.04 23.10 23.04 22.10 22.04 20.04 18.04 14.04 +1

Overview

The neutron-gateway charm deploys the data plane of Neutron, the core OpenStack service that provides software defined networking (SDN) for Nova instances. This provides the Neutron Gateway service, which in turn supplies two key services: L3 network routing and DHCP. The charm works alongside other Juju-deployed OpenStack applications; in particular: neutron-openvswitch, nova-compute, and nova-cloud-controller.

Note: Starting with OpenStack Train, the neutron-gateway and neutron-openvswitch charm combination can be replaced by the OVN charms (e.g. ovn-central, ovn-chassis, and neutron-api-plugin-ovn).

Important: This documentation supports version 3.x of the Juju client. See the OpenStack Charm guide if you are using the 2.9.x client.

Usage

Configuration

This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.

data-port

A bridge that Neutron Gateway will bind to, given in the form of a space-delimited bridge:port mapping (e.g. ‘br-ex:ens8’). The port will be added to its corresponding bridge.

Note: If network device names are not consistent between hosts (e.g. ‘eth1’ and ‘ens8’) a list of values can be provided where a MAC address is used in the place of a device name. The charm will iterate through the list and configure the first matching interface.

The specified bridge(s) should match the one(s) defined in the bridge-mappings option.

Flat or VLAN network types are supported.

The device itself must not have any L3 configuration. In MAAS, it must have an IP mode of ‘Unconfigured’.

bridge-mappings

A space-delimited list of ML2 data provider:bridge mappings (e.g. ‘physnet1:br-ex’). The specified bridge(s) should match the one(s) defined in the data-port option.

openstack-origin

The openstack-origin option states the software sources. A common value is an OpenStack UCA release (e.g. ‘cloud:bionic-ussuri’ or ‘cloud:focal-victoria’). See Ubuntu Cloud Archive. The underlying host’s existing apt sources will be used if this option is not specified (this behaviour can be explicitly chosen by using the value of ‘distro’).

Deployment

These deployment instructions assume the following pre-existing applications: neutron-api, nova-cloud-controller, and rabbitmq-server.

Important: For Neutron Gateway to function properly, the nova-cloud-controller charm must have its network-manager option set to ‘Neutron’.

Deploy Neutron Gateway:

juju deploy neutron-gateway
juju integrate neutron-gateway:quantum-network-service nova-cloud-controller:quantum-network-service
juju integrate neutron-gateway:neutron-plugin-api neutron-api:neutron-plugin-api
juju integrate neutron-gateway:amqp rabbitmq-server:amqp

Port configuration

Network ports are configured with the bridge-mappings and data-port options but the neutron-api charm also has several relevant options (e.g. flat-network-providers, vlan-ranges, etc.). Additionally, the network topology can be further defined with supplementary openstack client commands.

Example 1 This configuration has a single external network and is typically used when floating IP addresses are combined with a GRE private network.

Charm option values (YAML):

neutron-gateway:
    bridge-mappings: physnet1:br-ex
    data-port: br-ex:eth1
neutron-api:
    flat-network-providers: physnet1

Supplementary commands:

openstack network create --provider-network-type flat \
   --provider-physical-network physnet1 --external \
   external
openstack router set router1 --external-gateway external

Example 2 This configuration is for two networks, where an internal private network is directly connected to the gateway with public IP addresses but a floating IP address range is also offered.

Charm option values (YAML):

neutron-gateway:
    bridge-mappings: physnet1:br-data external:br-ex
    data-port: br-data:eth1 br-ex:eth2
neutron-api:
    flat-network-providers: physnet1 external

Example 3 This configuration has two external networks, where one is for public instance addresses and one is for floating IP addresses. Both networks are on the same physical network connection (but they might be on different VLANs).

Charm option values (YAML):

neutron-gateway:
    bridge-mappings: physnet1:br-data
    data-port: br-data:eth1
neutron-api:
    flat-network-providers: physnet1

Supplementary commands:

openstack network create --provider-network-type vlan \
   --provider-segment 400 \
   --provider-physical-network physnet1 --share \
   external
openstack network create --provider-network-type vlan \
   --provider-segment 401 \
   --provider-physical-network physnet1 --share --external \
   floating
openstack router set router1 --external-gateway floating

legacy ext-port option

The ext-port option is deprecated and is superseded by the data-port option. The ext-port option always created a bridge called ‘br-ex’ for external networks that was used implicitly by external router interfaces.

The following will occur if both the data-port and ext-port options are set:

  • the neutron-gateway unit will be marked as ‘blocked’ to indicate that the charm is misconfigured
  • the ext-port option will be ignored
  • a warning will be logged

Instance MTU

When using Open vSwitch plugin with GRE tunnels the default MTU of 1500 can cause packet fragmentation due to GRE overhead. One solution to this problem is to increase the MTU on physical hosts and network equipment. When this is not feasible the charm’s instance-mtu option can be used to reduce instance MTU via DHCP:

juju config neutron-gateway instance-mtu=1400

Note: The instance-mtu option is supported starting with OpenStack Havana.

Actions

This section covers Juju actions supported by the charm. Actions allow specific operations to be performed on a per-unit basis. To display action descriptions run juju actions --schema neutron-gateway. If the charm is not deployed then see file actions.yaml.

  • cleanup
  • get-status-dhcp
  • get-status-lb
  • get-status-routers
  • openstack-upgrade
  • pause
  • restart-services
  • resume
  • restart-services
  • run-deferred-hooks
  • security-checklist
  • show-deferred-events

Deferred service events

Operational or maintenance procedures applied to a cloud often lead to the restarting of various OpenStack services and/or the calling of certain charm hooks. Although normal, such events can be undesirable due to the service interruptions they can cause.

The deferred service events feature provides the operator the choice of preventing these service restarts and hook calls from occurring, which can then be resolved at a more opportune time.

See the Deferred service events page in the OpenStack Charms Deployment Guide for an in-depth treatment of this feature.

Documentation

The OpenStack Charms project maintains two documentation guides:

Bugs

Please report bugs on Launchpad.


Help improve this document in the forum (guidelines). Last updated 10 months ago.