dubzland.openstack.openstack_octavia role – Install and configure the OpenStack Octavia LBaaS 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_octavia.

Entry point main – Install and configure the OpenStack Octavia LBaaS 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 required provider networks in Neutron

Parameters

Parameter

Comments

openstack_octavia_amphora_public_key

string / required

Public key to be installed into amphora for ssh access.

openstack_octavia_db_name

string

Name of the MySQL database created.

Default: "octavia"

openstack_octavia_db_password

string / required

Database password created for the openstack_octavia_db_user.

openstack_octavia_db_user

string

Database user created for the OpenStack Octavia component.

Default: "octavia"

openstack_octavia_heartbeat_key

string / required

Key used for symmetric encryption of UDP heartbeat packets.

openstack_octavia_packages

list / elements=string

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

Default: ["debootstrap", "git", "kpartx", "octavia-api", "octavia-health-manager", "octavia-housekeeping", "octavia-worker", "python3-octavia", "python3-octavia-dashboard", "python3-octaviaclient", "qemu-utils"]

openstack_octavia_provider_network_allocation_pool

dictionary / required

IP address pool to use for Octavia amphora instances.

end

string / required

Last IP address available in the LBaaS pool.

start

string / required

First IP address available in the LBaaS pool.

openstack_octavia_provider_network_cidr

string / required

Network CIDR for the LBaaS provider network.

openstack_octavia_provider_network_ip

string / required

IP address of the controller node on the LBaaS network.

openstack_octavia_provider_network_name

string / required

Name of the created Neutron provider network for LBaaS traffic.

openstack_octavia_provider_network_segmentation_id

integer

VLAN tag to associate with this Neutron network. Required if openstack_octavia_provider_network_type is vlan.

openstack_octavia_provider_network_type

string / required

Type of the underlying OVN provider network being configured.

Choices:

  • "vlan"

  • "flat"

openstack_octavia_provider_physical_network

string / required

Underlying OVN network to use for LBaaS traffic. This network must be created separately in Neutron, and any necessary bridges must already exist. This is done automatically by the dubzland.openstack.openstack_neutron role.

openstack_octavia_provider_subnet_name

string

Name of the created Neutron provider subnet for LBaaS traffic.

Default: "{{ openstack_octavia_provider_network_name }}-subnet"

openstack_octavia_service_description

string

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

Default: "OpenStack LBaaS"

openstack_octavia_service_password

string / required

Service password assigned to the openstack_octavia_service_user.

openstack_octavia_service_user

string

User created in OpenStack Keystone for the Octavia component.

Default: "octavia"

openstack_octavia_services

list / elements=string

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

Default: ["octavia-api", "octavia-health-manager", "octavia-housekeeping", "octavia-worker"]