05d7733e2a
Add support for configuring 'mem_stats_period_seconds' libvirt config option. When using the balloon stats in the XML configuration, user gets latency violation in guests, because balloon stats causes QEMU to periodically send asynchronous requests to balloon driver in the guest. Change-Id: If69d32fb4b718b97efbfbe0d58a37966af957be9
368 lines
13 KiB
Puppet
368 lines
13 KiB
Puppet
# == Class: nova::compute::libvirt
|
|
#
|
|
# Install and manage nova-compute guests managed
|
|
# by libvirt
|
|
#
|
|
# === Parameters:
|
|
#
|
|
# [*ensure_package*]
|
|
# (optional) The state of nova packages
|
|
# Defaults to 'present'
|
|
#
|
|
# [*libvirt_virt_type*]
|
|
# (optional) Libvirt domain type. Options are: kvm, lxc, qemu, uml, xen
|
|
# Defaults to 'kvm'
|
|
#
|
|
# [*vncserver_listen*]
|
|
# (optional) IP address on which instance vncservers should listen
|
|
# Defaults to '127.0.0.1'
|
|
#
|
|
# [*migration_support*]
|
|
# (optional) Whether to support virtual machine migration
|
|
# Defaults to false
|
|
#
|
|
# [*libvirt_cpu_mode*]
|
|
# (optional) The libvirt CPU mode to configure. Possible values
|
|
# include custom, host-model, none, host-passthrough.
|
|
# Defaults to 'host-model' if libvirt_virt_type is set to kvm,
|
|
# otherwise defaults to 'none'.
|
|
#
|
|
# [*libvirt_cpu_model*]
|
|
# (optional) The named libvirt CPU model (see names listed in
|
|
# /usr/share/libvirt/cpu_map.xml). Only has effect if
|
|
# cpu_mode="custom" and virt_type="kvm|qemu".
|
|
# Defaults to undef
|
|
#
|
|
# [*libvirt_cpu_model_extra_flags*]
|
|
# (optional) This allows specifying granular CPU feature flags when
|
|
# specifying CPU models. Only has effect if cpu_mode is not set
|
|
# to 'none'.
|
|
# Defaults to undef
|
|
#
|
|
# [*libvirt_snapshot_image_format*]
|
|
# (optional) Format to save snapshots to. Some filesystems
|
|
# have a preference and only operate on raw or qcow2
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*libvirt_disk_cachemodes*]
|
|
# (optional) A list of cachemodes for different disk types, e.g.
|
|
# ["file=directsync", "block=none"]
|
|
# If an empty list is specified, the disk_cachemodes directive
|
|
# will be removed from nova.conf completely.
|
|
# Defaults to an empty list
|
|
#
|
|
# [*libvirt_hw_disk_discard*]
|
|
# (optional) Discard option for nova managed disks. Need Libvirt(1.0.6)
|
|
# Qemu1.5 (raw format) Qemu1.6(qcow2 format).
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*libvirt_hw_machine_type*]
|
|
# (optional) Option to specify a default machine type per host architecture.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*libvirt_inject_password*]
|
|
# (optional) Inject the admin password at boot time, without an agent.
|
|
# Defaults to false
|
|
#
|
|
# [*libvirt_inject_key*]
|
|
# (optional) Inject the ssh public key at boot time.
|
|
# Defaults to false
|
|
#
|
|
# [*libvirt_inject_partition*]
|
|
# (optional) The partition to inject to : -2 => disable, -1 => inspect
|
|
# (libguestfs only), 0 => not partitioned, >0 => partition
|
|
# number (integer value)
|
|
# Defaults to -2
|
|
#
|
|
# [*libvirt_enabled_perf_events*]
|
|
# (optional) This is a performance event list which could be used as monitor.
|
|
# A string list. For example: ``enabled_perf_events = cmt, mbml, mbmt``
|
|
# The supported events list can be found in
|
|
# https://libvirt.org/html/libvirt-libvirt-domain.html ,
|
|
# which you may need to search key words ``VIR_PERF_PARAM_*``
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*remove_unused_base_images*]
|
|
# (optional) Should unused base images be removed?
|
|
# If undef is specified, remove the line in nova.conf
|
|
# otherwise, use a boolean to remove or not the base images.
|
|
# Defaults to undef
|
|
#
|
|
# [*remove_unused_resized_minimum_age_seconds*]
|
|
# (optional) Unused resized base images younger
|
|
# than this will not be removed
|
|
# If undef is specified, remove the line in nova.conf
|
|
# otherwise, use a integer or a string to define after
|
|
# how many seconds it will be removed.
|
|
# Defaults to undef
|
|
#
|
|
# [*remove_unused_original_minimum_age_seconds*]
|
|
# (optional) Unused unresized base images younger
|
|
# than this will not be removed
|
|
# If undef is specified, remove the line in nova.conf
|
|
# otherwise, use a integer or a string to define after
|
|
# how many seconds it will be removed.
|
|
# Defaults to undef
|
|
#
|
|
# [*libvirt_service_name*]
|
|
# (optional) libvirt service name.
|
|
# Defaults to $::nova::params::libvirt_service_name
|
|
#
|
|
# [*virtlock_service_name*]
|
|
# (optional) virtlock service name.
|
|
# Defaults to $::nova::params::virtlock_service_name
|
|
#
|
|
# [*virtlog_service_name*]
|
|
# (optional) virtlog service name.
|
|
# Defaults to $::nova::params::virtlog_service_name
|
|
#
|
|
# [*compute_driver*]
|
|
# (optional) Compute driver.
|
|
# Defaults to 'libvirt.LibvirtDriver'
|
|
#
|
|
# [*preallocate_images*]
|
|
# (optional) The image preallocation mode to use.
|
|
# Valid values are 'none' or 'space'.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*manage_libvirt_services*]
|
|
# (optional) Whether or not deploy Libvirt services.
|
|
# In the case of micro-services, set it to False and use
|
|
# nova::compute::libvirt::services + hiera to select what
|
|
# you actually want to deploy.
|
|
# Defaults to true for backward compatibility.
|
|
#
|
|
# [*log_outputs*]
|
|
# (optional) Defines log outputs, as specified in
|
|
# https://libvirt.org/logging.html
|
|
# Defaults to undef
|
|
#
|
|
# [*rx_queue_size*]
|
|
# (optional) virtio-net rx queue size
|
|
# Valid values are 256, 512, 1024
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*tx_queue_size*]
|
|
# (optional) virtio-net tx queue size
|
|
# Valid values are 256, 512, 1024
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*file_backed_memory*]
|
|
# (optional) Available capacity in MiB for file-backed memory.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*volume_use_multipath*]
|
|
# (optional) Use multipath connection of the
|
|
# iSCSI or FC volume. Volumes can be connected in the
|
|
# LibVirt as multipath devices.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*nfs_mount_options*]
|
|
# (optional) Mount options passed to the NFS client. See section of the
|
|
# nfs man page for details.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*num_pcie_ports*]
|
|
# (optional) The number of PCIe ports an instance will get.
|
|
# Libvirt allows a custom number of PCIe ports (pcie-root-port controllers) a
|
|
# target instance will get. Some will be used by default, rest will be available
|
|
# for hotplug use.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
# [*mem_stats_period_seconds*]
|
|
# (optional) A number of seconds to memory usage statistics period,
|
|
# zero or negative value mean to disable memory usage statistics.
|
|
# Defaults to $::os_service_default
|
|
#
|
|
class nova::compute::libvirt (
|
|
$ensure_package = 'present',
|
|
$libvirt_virt_type = 'kvm',
|
|
$vncserver_listen = '127.0.0.1',
|
|
$migration_support = false,
|
|
$libvirt_cpu_mode = false,
|
|
$libvirt_cpu_model = undef,
|
|
$libvirt_cpu_model_extra_flags = undef,
|
|
$libvirt_snapshot_image_format = $::os_service_default,
|
|
$libvirt_disk_cachemodes = [],
|
|
$libvirt_hw_disk_discard = $::os_service_default,
|
|
$libvirt_hw_machine_type = $::os_service_default,
|
|
$libvirt_inject_password = false,
|
|
$libvirt_inject_key = false,
|
|
$libvirt_inject_partition = -2,
|
|
$libvirt_enabled_perf_events = $::os_service_default,
|
|
$remove_unused_base_images = undef,
|
|
$remove_unused_resized_minimum_age_seconds = undef,
|
|
$remove_unused_original_minimum_age_seconds = undef,
|
|
$libvirt_service_name = $::nova::params::libvirt_service_name,
|
|
$virtlock_service_name = $::nova::params::virtlock_service_name,
|
|
$virtlog_service_name = $::nova::params::virtlog_service_name,
|
|
$compute_driver = 'libvirt.LibvirtDriver',
|
|
$preallocate_images = $::os_service_default,
|
|
$manage_libvirt_services = true,
|
|
$log_outputs = undef,
|
|
$rx_queue_size = $::os_service_default,
|
|
$tx_queue_size = $::os_service_default,
|
|
$file_backed_memory = undef,
|
|
$volume_use_multipath = $::os_service_default,
|
|
$nfs_mount_options = $::os_service_default,
|
|
$num_pcie_ports = $::os_service_default,
|
|
$mem_stats_period_seconds = $::os_service_default,
|
|
) inherits nova::params {
|
|
|
|
include ::nova::deps
|
|
include ::nova::params
|
|
|
|
# libvirt_cpu_mode has different defaults depending on hypervisor.
|
|
if !$libvirt_cpu_mode {
|
|
case $libvirt_virt_type {
|
|
'kvm': {
|
|
$libvirt_cpu_mode_real = 'host-model'
|
|
}
|
|
default: {
|
|
$libvirt_cpu_mode_real = 'none'
|
|
}
|
|
}
|
|
} else {
|
|
$libvirt_cpu_mode_real = $libvirt_cpu_mode
|
|
}
|
|
|
|
if($::osfamily == 'Debian') {
|
|
package { "nova-compute-${libvirt_virt_type}":
|
|
ensure => $ensure_package,
|
|
tag => ['openstack', 'nova-package'],
|
|
}
|
|
}
|
|
|
|
if $migration_support {
|
|
include ::nova::migration::libvirt
|
|
}
|
|
|
|
if $log_outputs {
|
|
libvirtd_config {
|
|
'log_outputs': value => "\"${log_outputs}\"";
|
|
}
|
|
}
|
|
|
|
unless $rx_queue_size == $::os_service_default or $rx_queue_size in [256, 512, 1024] {
|
|
fail("Invalid rx_queue_size parameter: ${rx_queue_size}")
|
|
}
|
|
|
|
unless $tx_queue_size == $::os_service_default or $tx_queue_size in [256, 512, 1024] {
|
|
fail("Invalid_tx_queue_size parameter: ${tx_queue_size}")
|
|
}
|
|
|
|
# manage_libvirt_services is here for backward compatibility to support
|
|
# deployments that do not include nova::compute::libvirt::services
|
|
#
|
|
# If you're using hiera:
|
|
# - set nova::compute::libvirt::manage_libvirt_services to false
|
|
# - include ::nova::compute::libvirt::services in your composition layer
|
|
# - select which services you want to deploy with
|
|
# ::nova::compute::libvirt::services:* parameters.
|
|
#
|
|
# If you're not using hiera:
|
|
# - set nova::compute::libvirt::manage_libvirt_services to true (default).
|
|
# - select which services you want to deploy with
|
|
# ::nova::compute::libvirt::*_service_name parameters.
|
|
if $manage_libvirt_services {
|
|
class { '::nova::compute::libvirt::services':
|
|
libvirt_service_name => $libvirt_service_name,
|
|
virtlock_service_name => $virtlock_service_name,
|
|
virtlog_service_name => $virtlog_service_name,
|
|
libvirt_virt_type => $libvirt_virt_type,
|
|
}
|
|
}
|
|
|
|
nova_config {
|
|
'DEFAULT/compute_driver': value => $compute_driver;
|
|
'DEFAULT/preallocate_images': value => $preallocate_images;
|
|
'vnc/vncserver_listen': value => $vncserver_listen;
|
|
'libvirt/virt_type': value => $libvirt_virt_type;
|
|
'libvirt/cpu_mode': value => $libvirt_cpu_mode_real;
|
|
'libvirt/snapshot_image_format': value => $libvirt_snapshot_image_format;
|
|
'libvirt/inject_password': value => $libvirt_inject_password;
|
|
'libvirt/inject_key': value => $libvirt_inject_key;
|
|
'libvirt/inject_partition': value => $libvirt_inject_partition;
|
|
'libvirt/hw_disk_discard': value => $libvirt_hw_disk_discard;
|
|
'libvirt/hw_machine_type': value => $libvirt_hw_machine_type;
|
|
'libvirt/enabled_perf_events': value => join(any2array($libvirt_enabled_perf_events), ',');
|
|
'libvirt/rx_queue_size': value => $rx_queue_size;
|
|
'libvirt/tx_queue_size': value => $tx_queue_size;
|
|
'libvirt/file_backed_memory': value => $file_backed_memory;
|
|
'libvirt/volume_use_multipath': value => $volume_use_multipath;
|
|
'libvirt/nfs_mount_options': value => $nfs_mount_options;
|
|
'libvirt/num_pcie_ports': value => $num_pcie_ports;
|
|
'libvirt/mem_stats_period_seconds': value => $mem_stats_period_seconds;
|
|
}
|
|
|
|
# cpu_model param is only valid if cpu_mode=custom
|
|
# otherwise it should be commented out
|
|
if $libvirt_cpu_mode_real == 'custom' {
|
|
validate_legacy(String, 'validate_string', $libvirt_cpu_model)
|
|
nova_config {
|
|
'libvirt/cpu_model': value => $libvirt_cpu_model;
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'libvirt/cpu_model': ensure => absent;
|
|
}
|
|
if $libvirt_cpu_model {
|
|
warning('$libvirt_cpu_model requires that $libvirt_cpu_mode => "custom" and will be ignored')
|
|
}
|
|
}
|
|
|
|
if $libvirt_cpu_mode_real != 'none' {
|
|
validate_legacy(String, 'validate_string', $libvirt_cpu_model_extra_flags)
|
|
nova_config {
|
|
'libvirt/cpu_model_extra_flags': value => $libvirt_cpu_model_extra_flags;
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'libvirt/cpu_model_extra_flags': ensure => absent;
|
|
}
|
|
if $libvirt_cpu_model_extra_flags {
|
|
warning('$libvirt_cpu_model_extra_flags requires that $libvirt_cpu_mode is not set to "none" and will be ignored')
|
|
}
|
|
}
|
|
|
|
if size($libvirt_disk_cachemodes) > 0 {
|
|
nova_config {
|
|
'libvirt/disk_cachemodes': value => join($libvirt_disk_cachemodes, ',');
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'libvirt/disk_cachemodes': ensure => absent;
|
|
}
|
|
}
|
|
|
|
if $remove_unused_resized_minimum_age_seconds != undef {
|
|
nova_config {
|
|
'libvirt/remove_unused_resized_minimum_age_seconds': value => $remove_unused_resized_minimum_age_seconds;
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'libvirt/remove_unused_resized_minimum_age_seconds': ensure => absent;
|
|
}
|
|
}
|
|
|
|
if $remove_unused_base_images != undef {
|
|
nova_config {
|
|
'DEFAULT/remove_unused_base_images': value => $remove_unused_base_images;
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'DEFAULT/remove_unused_base_images': ensure => absent;
|
|
}
|
|
}
|
|
|
|
if $remove_unused_original_minimum_age_seconds != undef {
|
|
nova_config {
|
|
'DEFAULT/remove_unused_original_minimum_age_seconds': value => $remove_unused_original_minimum_age_seconds;
|
|
}
|
|
} else {
|
|
nova_config {
|
|
'DEFAULT/remove_unused_original_minimum_age_seconds': ensure => absent;
|
|
}
|
|
}
|
|
}
|