17fe2a35c4
Use review.opendev.org instead of review.openstack.org. You can see the discussion below: http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html Change-Id: I1e2a4d374b9c2d1dc46ab3758bd3c6f0b93d24fc
522 lines
20 KiB
Puppet
522 lines
20 KiB
Puppet
# == Class: neutron
|
|
#
|
|
# Installs the neutron package and configures
|
|
# /etc/neutron/neutron.conf
|
|
#
|
|
# === Parameters:
|
|
#
|
|
# [*enabled*]
|
|
# (required) Whether or not to enable the neutron service
|
|
# true/false
|
|
#
|
|
# [*package_ensure*]
|
|
# (optional) The state of the package
|
|
# Defaults to 'present'
|
|
#
|
|
# [*bind_host*]
|
|
# (optional) The IP/interface to bind to
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*bind_port*]
|
|
# (optional) The port to use
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*core_plugin*]
|
|
# (optional) Neutron plugin provider
|
|
# Defaults to ml2
|
|
# Could be bigswitch, brocade, cisco, embrane, hyperv, midonet,
|
|
# ml2, mlnx, nec, nicira, plumgrid, ryu, nuage, opencontrail, nsx
|
|
#
|
|
# Example for nuage:
|
|
#
|
|
# class {'neutron' :
|
|
# core_plugin => 'nuage'
|
|
# }
|
|
#
|
|
# [*service_plugins*]
|
|
# (optional) Advanced service modules.
|
|
# Could be an array that can have these elements:
|
|
# router, firewall, lbaas, vpnaas, metering, qos
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*auth_strategy*]
|
|
# (optional) How to authenticate
|
|
# Defaults to 'keystone'. 'noauth' and 'keystone' are the only valid options
|
|
#
|
|
# [*base_mac*]
|
|
# (optional) The MAC address pattern to use.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*dhcp_lease_duration*]
|
|
# (optional) DHCP lease
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*host*]
|
|
# (optional) Hostname to be used by the server, agents and services.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*dns_domain*]
|
|
# (optional) Domain to use for building the hostnames
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*dhcp_agents_per_network*]
|
|
# (optional) Number of DHCP agents scheduled to host a network.
|
|
# This enables redundant DHCP agents for configured networks.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*global_physnet_mtu*]
|
|
# (optional) The MTU size for the interfaces managed by neutron
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*dhcp_agent_notification*]
|
|
# (optional) Allow sending resource operation notification to DHCP agent.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*allow_bulk*]
|
|
# (optional) Enable bulk crud operations
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*allow_overlapping_ips*]
|
|
# (optional) Enables network namespaces
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*api_extensions_path*]
|
|
# (optional) Specify additional paths for API extensions that the
|
|
# module in use needs to load.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*root_helper*]
|
|
# (optional) Use "sudo neutron-rootwrap /etc/neutron/rootwrap.conf" to use the real
|
|
# root filter facility. Change to "sudo" to skip the filtering and just run the command
|
|
# directly
|
|
# Defaults to 'sudo neutron-rootwrap /etc/neutron/rootwrap.conf'.
|
|
#
|
|
# [*root_helper_daemon*]
|
|
# (optional) Root helper daemon application to use when possible.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*report_interval*]
|
|
# (optional) Seconds between nodes reporting state to server; should be less than
|
|
# agent_down_time, best if it is half or less than agent_down_time.
|
|
# agent_down_time is a config for neutron-server, set by class neutron::server
|
|
# report_interval is a config for neutron agents, set by class neutron
|
|
# Defaults to: $::os_service_default
|
|
#
|
|
# [*control_exchange*]
|
|
# (optional) What RPC queue/exchange to use
|
|
# Defaults to neutron
|
|
#
|
|
# [*default_transport_url*]
|
|
# (optional) A URL representing the messaging driver to use and its full
|
|
# configuration. Transport URLs take the form:
|
|
# transport://user:pass@host1:port[,hostN:portN]/virtual_host
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rpc_response_timeout*]
|
|
# (optional) Seconds to wait for a response from a call
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rabbit_ha_queues*]
|
|
# (Optional) Use HA queues in RabbitMQ.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rabbit_heartbeat_timeout_threshold*]
|
|
# (optional) Number of seconds after which the RabbitMQ broker is considered
|
|
# down if the heartbeat keepalive fails. Any value >0 enables heartbeats.
|
|
# Heartbeating helps to ensure the TCP connection to RabbitMQ isn't silently
|
|
# closed, resulting in missed or lost messages from the queue.
|
|
# (Requires kombu >= 3.0.7 and amqp >= 1.4.0)
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rabbit_heartbeat_rate*]
|
|
# (optional) How often during the rabbit_heartbeat_timeout_threshold period to
|
|
# check the heartbeat on RabbitMQ connection. (i.e. rabbit_heartbeat_rate=2
|
|
# when rabbit_heartbeat_timeout_threshold=60, the heartbeat will be checked
|
|
# every 30 seconds.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rabbit_use_ssl*]
|
|
# (optional) Connect over SSL for RabbitMQ
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*rabbit_transient_queues_ttl*]
|
|
# (optional) Positive integer representing duration in seconds for queue
|
|
# TTL (x-expires). Queues which are unused for the duration of the TTL are
|
|
# automatically deleted. The parameter affects only reply and fanout queues.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*amqp_durable_queues*]
|
|
# (optional) Define queues as "durable" to rabbitmq.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_ssl_ca_certs*]
|
|
# (optional) SSL certification authority file (valid only if SSL enabled).
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_ssl_certfile*]
|
|
# (optional) SSL cert file (valid only if SSL enabled).
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_ssl_keyfile*]
|
|
# (optional) SSL key file (valid only if SSL enabled).
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_ssl_version*]
|
|
# (optional) SSL version to use (valid only if SSL enabled).
|
|
# Valid values are TLSv1, SSLv23 and SSLv3. SSLv2 may be
|
|
# available on some distributions.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_reconnect_delay*]
|
|
# (optional) The amount of time to wait before attempting to reconnect
|
|
# to MQ provider. This is used in some cases where you may need to wait
|
|
# for the provider to propery premote the master before attempting to
|
|
# reconnect. See https://review.opendev.org/#/c/76686
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_missing_consumer_retry_timeout*]
|
|
# (Optional) How long to wait a missing client beforce abandoning to send it
|
|
# its replies. This value should not be longer than rpc_response_timeout.
|
|
# (integer value)
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_failover_strategy*]
|
|
# (Optional) Determines how the next RabbitMQ node is chosen in case the one
|
|
# we are currently connected to becomes unavailable. Takes effect only if
|
|
# more than one RabbitMQ node is provided in config. (string value)
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*kombu_compression*]
|
|
# (optional) Possible values are: gzip, bz2. If not set compression will not
|
|
# be used. This option may notbe available in future versions. EXPERIMENTAL.
|
|
# (string value)
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*amqp_server_request_prefix*]
|
|
# (Optional) Address prefix used when sending to a specific server
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_broadcast_prefix*]
|
|
# (Optional) address prefix used when broadcasting to all servers
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_group_request_prefix*]
|
|
# (Optional) address prefix when sending to any server in group
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_container_name*]
|
|
# (Optional) Name for the AMQP container
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_idle_timeout*]
|
|
# (Optional) Timeout for inactive connections
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_trace*]
|
|
# (Optional) Debug: dump AMQP frames to stdout
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_ssl_ca_file*]
|
|
# (Optional) CA certificate PEM file to verify server certificate
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_ssl_cert_file*]
|
|
# (Optional) Identifying certificate PEM file to present to clients
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_ssl_key_file*]
|
|
# (Optional) Private key PEM file used to sign cert_file certificate
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_ssl_key_password*]
|
|
# (Optional) Password for decrypting ssl_key_file (if encrypted)
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_allow_insecure_clients*]
|
|
# (Optional) Accept clients using either SSL or plain TCP
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_sasl_mechanisms*]
|
|
# (Optional) Space separated list of acceptable SASL mechanisms
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_sasl_config_dir*]
|
|
# (Optional) Path to directory that contains the SASL configuration
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_sasl_config_name*]
|
|
# (Optional) Name of configuration file (without .conf suffix)
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_username*]
|
|
# (Optional) User name for message broker authentication
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*amqp_password*]
|
|
# (Optional) Password for message broker authentication
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*use_ssl*]
|
|
# (optinal) Enable SSL on the API server
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*cert_file*]
|
|
# (optinal) certificate file to use when starting api server securely
|
|
# defaults to $::os_service_default
|
|
#
|
|
# [*key_file*]
|
|
# (optional) Private key file to use when starting API server securely
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*ca_file*]
|
|
# (optional) CA certificate file to use to verify connecting clients
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*state_path*]
|
|
# (optional) Where to store state files. This directory must be writable
|
|
# by the user executing the agent
|
|
# Defaults to: $::os_service_default
|
|
#
|
|
# [*lock_path*]
|
|
# (optional) Where to store lock files. This directory must be writeable
|
|
# by the user executing the agent
|
|
# Defaults to: '$state_path/lock'
|
|
#
|
|
# [*purge_config*]
|
|
# (optional) Whether to set only the specified config options
|
|
# in the neutron config.
|
|
# Defaults to false.
|
|
#
|
|
# [*notification_driver*]
|
|
# (optional) Driver or drivers to handle sending notifications.
|
|
# Value can be a string or a list.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*notification_topics*]
|
|
# (optional) AMQP topic used for OpenStack notifications
|
|
# Defaults to ::os_service_default
|
|
#
|
|
# [*notification_transport_url*]
|
|
# (optional) A URL representing the messaging driver to use for
|
|
# notifications and its full configuration. Transport URLs
|
|
# take the form:
|
|
# transport://user:pass@host1:port[,hostN:portN]/virtual_host
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*max_allowed_address_pair*]
|
|
# (optional) Maximum number of allowed address pairs per port
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*vlan_transparent*]
|
|
# (optional) Allow plugins that support it to create VLAN transparent networks
|
|
# Defaults to $::os_service_default
|
|
#
|
|
## DEPRECATED PARAMS
|
|
#
|
|
# [*manage_logging*]
|
|
# (optional) Whether to manage olso.logging options
|
|
# If set to false, neutron::logging class should be evaluated
|
|
# Defaults to undef.
|
|
#
|
|
class neutron (
|
|
$enabled = true,
|
|
$package_ensure = 'present',
|
|
$bind_host = $::os_service_default,
|
|
$bind_port = $::os_service_default,
|
|
$core_plugin = 'ml2',
|
|
$service_plugins = $::os_service_default,
|
|
$auth_strategy = 'keystone',
|
|
$base_mac = $::os_service_default,
|
|
$dhcp_lease_duration = $::os_service_default,
|
|
$host = $::os_service_default,
|
|
$dns_domain = $::os_service_default,
|
|
$dhcp_agents_per_network = $::os_service_default,
|
|
$global_physnet_mtu = $::os_service_default,
|
|
$dhcp_agent_notification = $::os_service_default,
|
|
$allow_bulk = $::os_service_default,
|
|
$allow_overlapping_ips = $::os_service_default,
|
|
$api_extensions_path = $::os_service_default,
|
|
$root_helper = 'sudo neutron-rootwrap /etc/neutron/rootwrap.conf',
|
|
$root_helper_daemon = $::os_service_default,
|
|
$report_interval = $::os_service_default,
|
|
$control_exchange = 'neutron',
|
|
$default_transport_url = $::os_service_default,
|
|
$rpc_response_timeout = $::os_service_default,
|
|
$rabbit_ha_queues = $::os_service_default,
|
|
$rabbit_heartbeat_timeout_threshold = $::os_service_default,
|
|
$rabbit_heartbeat_rate = $::os_service_default,
|
|
$rabbit_use_ssl = $::os_service_default,
|
|
$rabbit_transient_queues_ttl = $::os_service_default,
|
|
$amqp_durable_queues = $::os_service_default,
|
|
$kombu_ssl_ca_certs = $::os_service_default,
|
|
$kombu_ssl_certfile = $::os_service_default,
|
|
$kombu_ssl_keyfile = $::os_service_default,
|
|
$kombu_ssl_version = $::os_service_default,
|
|
$kombu_reconnect_delay = $::os_service_default,
|
|
$kombu_missing_consumer_retry_timeout = $::os_service_default,
|
|
$kombu_failover_strategy = $::os_service_default,
|
|
$kombu_compression = $::os_service_default,
|
|
$amqp_server_request_prefix = $::os_service_default,
|
|
$amqp_broadcast_prefix = $::os_service_default,
|
|
$amqp_group_request_prefix = $::os_service_default,
|
|
$amqp_container_name = $::os_service_default,
|
|
$amqp_idle_timeout = $::os_service_default,
|
|
$amqp_trace = $::os_service_default,
|
|
$amqp_ssl_ca_file = $::os_service_default,
|
|
$amqp_ssl_cert_file = $::os_service_default,
|
|
$amqp_ssl_key_file = $::os_service_default,
|
|
$amqp_ssl_key_password = $::os_service_default,
|
|
$amqp_allow_insecure_clients = $::os_service_default,
|
|
$amqp_sasl_mechanisms = $::os_service_default,
|
|
$amqp_sasl_config_dir = $::os_service_default,
|
|
$amqp_sasl_config_name = $::os_service_default,
|
|
$amqp_username = $::os_service_default,
|
|
$amqp_password = $::os_service_default,
|
|
$use_ssl = $::os_service_default,
|
|
$cert_file = $::os_service_default,
|
|
$key_file = $::os_service_default,
|
|
$ca_file = $::os_service_default,
|
|
$state_path = $::os_service_default,
|
|
$lock_path = '$state_path/lock',
|
|
$purge_config = false,
|
|
$notification_driver = $::os_service_default,
|
|
$notification_topics = $::os_service_default,
|
|
$notification_transport_url = $::os_service_default,
|
|
$max_allowed_address_pair = $::os_service_default,
|
|
$vlan_transparent = $::os_service_default,
|
|
## DEPRECATED PARAMS
|
|
$manage_logging = undef,
|
|
) {
|
|
|
|
include ::neutron::deps
|
|
include ::neutron::params
|
|
|
|
if $manage_logging {
|
|
warning('neutron::manage_logging is deprecated and has no effect, please use neutron::logging class')
|
|
}
|
|
|
|
if ! is_service_default($use_ssl) and ($use_ssl) {
|
|
if is_service_default($cert_file) {
|
|
fail('The cert_file parameter is required when use_ssl is set to true')
|
|
}
|
|
if is_service_default($key_file) {
|
|
fail('The key_file parameter is required when use_ssl is set to true')
|
|
}
|
|
}
|
|
|
|
if ! is_service_default($use_ssl) and !($use_ssl) {
|
|
if ! is_service_default($ca_file) and ($ca_file) {
|
|
fail('The ca_file parameter requires that use_ssl to be set to true')
|
|
}
|
|
}
|
|
|
|
if (is_service_default($kombu_ssl_certfile) and ! is_service_default($kombu_ssl_keyfile))
|
|
or (is_service_default($kombu_ssl_keyfile) and ! is_service_default($kombu_ssl_certfile)) {
|
|
fail('The kombu_ssl_certfile and kombu_ssl_keyfile parameters must be used together')
|
|
}
|
|
if ! is_service_default($kombu_missing_consumer_retry_timeout) and ! is_service_default($rpc_response_timeout)
|
|
and ($kombu_missing_consumer_retry_timeout > $rpc_response_timeout) {
|
|
warning('kombu_missing_consumer_retry_timeout should not be longer than rpc_response_timeout')
|
|
}
|
|
|
|
package { 'neutron':
|
|
ensure => $package_ensure,
|
|
name => $::neutron::params::package_name,
|
|
tag => ['openstack', 'neutron-package'],
|
|
}
|
|
|
|
resources { 'neutron_config':
|
|
purge => $purge_config,
|
|
}
|
|
|
|
neutron_config {
|
|
'DEFAULT/bind_host': value => $bind_host;
|
|
'DEFAULT/bind_port': value => $bind_port;
|
|
'DEFAULT/auth_strategy': value => $auth_strategy;
|
|
'DEFAULT/core_plugin': value => $core_plugin;
|
|
'DEFAULT/base_mac': value => $base_mac;
|
|
'DEFAULT/dhcp_lease_duration': value => $dhcp_lease_duration;
|
|
'DEFAULT/host': value => $host;
|
|
'DEFAULT/dns_domain': value => $dns_domain;
|
|
'DEFAULT/dhcp_agents_per_network': value => $dhcp_agents_per_network;
|
|
'DEFAULT/dhcp_agent_notification': value => $dhcp_agent_notification;
|
|
'DEFAULT/allow_bulk': value => $allow_bulk;
|
|
'DEFAULT/allow_overlapping_ips': value => $allow_overlapping_ips;
|
|
'DEFAULT/api_extensions_path': value => $api_extensions_path;
|
|
'DEFAULT/state_path': value => $state_path;
|
|
'DEFAULT/global_physnet_mtu': value => $global_physnet_mtu;
|
|
'DEFAULT/max_allowed_address_pair': value => $max_allowed_address_pair;
|
|
'DEFAULT/vlan_transparent': value => $vlan_transparent;
|
|
'agent/root_helper': value => $root_helper;
|
|
'agent/root_helper_daemon': value => $root_helper_daemon;
|
|
'agent/report_interval': value => $report_interval;
|
|
}
|
|
|
|
oslo::messaging::default { 'neutron_config':
|
|
transport_url => $default_transport_url,
|
|
rpc_response_timeout => $rpc_response_timeout,
|
|
control_exchange => $control_exchange,
|
|
}
|
|
|
|
oslo::concurrency { 'neutron_config': lock_path => $lock_path }
|
|
|
|
oslo::messaging::notifications { 'neutron_config':
|
|
driver => $notification_driver,
|
|
topics => $notification_topics,
|
|
transport_url => $notification_transport_url,
|
|
}
|
|
|
|
if ! is_service_default ($service_plugins) and ($service_plugins) {
|
|
if is_array($service_plugins) {
|
|
neutron_config { 'DEFAULT/service_plugins': value => join($service_plugins, ',') }
|
|
} else {
|
|
fail('service_plugins should be an array.')
|
|
}
|
|
}
|
|
|
|
oslo::messaging::rabbit {'neutron_config':
|
|
heartbeat_timeout_threshold => $rabbit_heartbeat_timeout_threshold,
|
|
heartbeat_rate => $rabbit_heartbeat_rate,
|
|
rabbit_use_ssl => $rabbit_use_ssl,
|
|
rabbit_transient_queues_ttl => $rabbit_transient_queues_ttl,
|
|
kombu_reconnect_delay => $kombu_reconnect_delay,
|
|
kombu_missing_consumer_retry_timeout => $kombu_missing_consumer_retry_timeout,
|
|
kombu_failover_strategy => $kombu_failover_strategy,
|
|
kombu_compression => $kombu_compression,
|
|
kombu_ssl_ca_certs => $kombu_ssl_ca_certs,
|
|
kombu_ssl_certfile => $kombu_ssl_certfile,
|
|
kombu_ssl_keyfile => $kombu_ssl_keyfile,
|
|
amqp_durable_queues => $amqp_durable_queues,
|
|
rabbit_ha_queues => $rabbit_ha_queues,
|
|
kombu_ssl_version => $kombu_ssl_version,
|
|
}
|
|
|
|
oslo::messaging::amqp { 'neutron_config':
|
|
server_request_prefix => $amqp_server_request_prefix,
|
|
broadcast_prefix => $amqp_broadcast_prefix,
|
|
group_request_prefix => $amqp_group_request_prefix,
|
|
container_name => $amqp_container_name,
|
|
idle_timeout => $amqp_idle_timeout,
|
|
trace => $amqp_trace,
|
|
ssl_ca_file => $amqp_ssl_ca_file,
|
|
ssl_cert_file => $amqp_ssl_cert_file,
|
|
ssl_key_file => $amqp_ssl_key_file,
|
|
ssl_key_password => $amqp_ssl_key_password,
|
|
allow_insecure_clients => $amqp_allow_insecure_clients,
|
|
sasl_mechanisms => $amqp_sasl_mechanisms,
|
|
sasl_config_dir => $amqp_sasl_config_dir,
|
|
sasl_config_name => $amqp_sasl_config_name,
|
|
username => $amqp_username,
|
|
password => $amqp_password,
|
|
}
|
|
|
|
# SSL Options
|
|
neutron_config {
|
|
'DEFAULT/use_ssl': value => $use_ssl;
|
|
'ssl/cert_file': value => $cert_file;
|
|
'ssl/key_file': value => $key_file;
|
|
'ssl/ca_file': value => $ca_file;
|
|
}
|
|
|
|
}
|