dubzland.openstack.openstack_neutron role – Install and configure the OpenStack Neutron networking component.

Note

This role is part of the dubzland.openstack collection (version 1.1.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install dubzland.openstack.

To use it in a playbook, specify: dubzland.openstack.openstack_neutron.

Entry point main – Install and configure the OpenStack Neutron networking component.

Synopsis

  • Creates databases and configures users

  • Creates OpenStack services and associated users

  • Creates OpenStack endpoints within OpenStack Keystone

  • Installs required operating system packages

  • Applies desired configuration using templates

  • Creates necessary network bridges

  • Configures OVN/Open-vSwitch

Parameters

Parameter

Comments

openstack_neutron_api_worker_count

integer

Number of API worker instances to start. Defaults to the number of CPU cores present on the controller.

openstack_neutron_compute_packages

list / elements=string

List of packages installed on the compute nodes for the Neutron component.

Default: ["neutron-common", "neutron-plugin-ml2", "neutron-ovn-metadata-agent", "ovn-host"]

openstack_neutron_compute_services

list / elements=string

Services to be restarted during install (and/or configuration changes) on the compute nodes.

Default: ["neutron-ovn-metadata-agent"]

openstack_neutron_controller_packages

list / elements=string

List of packages installed on the controller node for the Neutron component.

Default: ["neutron-server", "openvswitch-switch", "ovn-central"]

openstack_neutron_controller_services

list / elements=string

Services to be restarted during install (and/or configuration changes) on the controller node.

Default: ["neutron-server"]

openstack_neutron_db_name

string

Name of the MySQL database created.

Default: "neutron"

openstack_neutron_db_password

string / required

Database password created for the openstack_neutron_db_user.

openstack_neutron_db_user

string

Database user created for the OpenStack Neutron component.

Default: "neutron"

openstack_neutron_designate_enabled

boolean

Controls whether Neutron is integrated with Designate for automatic DNS record management.

Choices:

  • false ← (default)

  • true

openstack_neutron_dns_domain

string

Default DNS domain name to use for building hostnames on networks that do not have a domain name assigned.

Default: "openstacklocal"

openstack_neutron_geneve_network_ranges

list / elements=string

List of VLAN ranges allowed for geneve tenant networks.

Default: ["1:1000"]

openstack_neutron_metadata_secret

string / required

Secret shared between Nova and Neutron for communication.

openstack_neutron_ovn_tunnel_address

string

IP Address on the tunnel network for this node. Must be specified for all compute nodes.

openstack_neutron_provider_network_mappings

list / elements=dictionary

List of mappings from OVN networks to physical networks. Required for compute nodes.

bridge

string / required

Open-vSwitch bridge to be created for this provider network.

interface

string / required

Physical network interface to be attached to the bridge for network communication.

name

string / required

Name of the provider network. Must match the value in openstack_neutron_provider_networks.

openstack_neutron_provider_networks

list / elements=dictionary

List of provider networks to configure in Open-vSwitch/OVN. Must be specified for the controller.

name

string / required

Name within OVN for the specified provider network.

range

string / required

Range of vlan ids (xxx:xxx) allowed on the provider network.

type

string / required

Type of underlying provider network being managed.

Choices:

  • "vlan"

  • "flat"

openstack_neutron_ptr_zone_email

string

The email address to be used when creating PTR zones.

Default: "admin@{{ openstack_neutron_dns_domain }}"

openstack_neutron_service_description

string

Human-readable description for the OpenStack Neutron service within Keystone.

Default: "OpenStack Networking"

openstack_neutron_service_password

string / required

Service password assigned to the openstack_neutron_service_user.

openstack_neutron_service_user

string

User created in OpenStack Keystone for the Neutron component.

Default: "neutron"

openstack_neutron_tenant_network_types

list / elements=string

List of allowed tenant network types.

Default: ["geneve"]