Puppet Class: neutron::agents::ml2::sriov

Defined in:
manifests/agents/ml2/sriov.pp

Overview

Copyright © 2014 eNovance SAS <licensing@enovance.com>

Author: Emilien Macchi <emilien.macchi@enovance.com>

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Class: neutron::agents::ml2::sriov

Setups SR-IOV neutron agent when using ML2 plugin

Parameters

package_ensure

(optional) The state of the package Defaults to ‘present’

enabled

(required) Whether or not to enable the OVS Agent Defaults to true

manage_service

(optional) Whether to start/stop the service Defaults to true

physical_device_mappings

(optional) Array of <physical_network>:<physical device> All physical networks listed in network_vlan_ranges on the server should have mappings to appropriate interfaces on each agent. Value should be of type array, Defaults to $::os_service_default

polling_interval

(optional) The number of seconds the agent will wait between polling for local device changes. Defaults to ‘2“

exclude_devices

(optional) Array of <network_device>:<excluded_devices> mapping network_device to the agent’s node-specific list of virtual functions that should not be used for virtual networking. excluded_devices is a semicolon separated list of virtual functions to exclude from network_device. The network_device in the mapping should appear in the physical_device_mappings list. Value should be of type array, Defaults to $::os_service_default

extensions

(optional) Extensions list to use Defaults to $::os_service_default

purge_config

(optional) Whether to set only the specified config options in the sriov config. Defaults to false.

number_of_vfs

(optional) List of <physical_network>:<number_of_vfs> specifying the number VFs to be exposed per physical interface. For example, to configure two inteface with number of VFs, specify it as “eth1:4,eth2:10” Defaults to $::os_service_default.

resource_provider_bandwidths

(optional) List of <network_device>:<egress_bw>:<ingress_bw> Defaults to empty list

Parameters:

  • package_ensure (Any) (defaults to: 'present')
  • enabled (Any) (defaults to: true)
  • manage_service (Any) (defaults to: true)
  • physical_device_mappings (Any) (defaults to: $::os_service_default)
  • polling_interval (Any) (defaults to: 2)
  • exclude_devices (Any) (defaults to: $::os_service_default)
  • extensions (Any) (defaults to: $::os_service_default)
  • purge_config (Any) (defaults to: false)
  • number_of_vfs (Any) (defaults to: $::os_service_default)
  • resource_provider_bandwidths (Any) (defaults to: []) 


76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
 
# File 'manifests/agents/ml2/sriov.pp', line 76

class neutron::agents::ml2::sriov (
  $package_ensure               = 'present',
  $enabled                      = true,
  $manage_service               = true,
  $physical_device_mappings     = $::os_service_default,
  $polling_interval             = 2,
  $exclude_devices              = $::os_service_default,
  $extensions                   = $::os_service_default,
  $purge_config                 = false,
  $number_of_vfs                = $::os_service_default,
  $resource_provider_bandwidths = [],
) {

  include neutron::deps
  include neutron::params

  resources { 'neutron_sriov_agent_config':
    purge => $purge_config,
  }

  neutron_sriov_agent_config {
    'sriov_nic/exclude_devices':          value => pick(join(any2array($exclude_devices), ','), $::os_service_default);
    'sriov_nic/physical_device_mappings': value => pick(join(any2array($physical_device_mappings), ','), $::os_service_default);
    'agent/extensions':                   value => join(any2array($extensions), ',');
    'agent/polling_interval':             value => $polling_interval;
    # As of now security groups are not supported for SR-IOV ports.
    # It is required to disable Firewall driver in the SR-IOV agent config.
    'securitygroup/firewall_driver':      value => 'noop';
  }

  if !is_service_default($number_of_vfs) and !empty($number_of_vfs) {
    neutron_agent_sriov_numvfs { $number_of_vfs: ensure => present }
  }

  package { 'neutron-sriov-nic-agent':
    ensure => $package_ensure,
    name   => $::neutron::params::sriov_nic_agent_package,
    tag    => ['openstack', 'neutron-package'],
  }

  if $manage_service {
    if $enabled {
      $service_ensure = 'running'
    } else {
      $service_ensure = 'stopped'
    }
  }

  service { 'neutron-sriov-nic-agent-service':
    ensure => $service_ensure,
    name   => $::neutron::params::sriov_nic_agent_service,
    enable => $enabled,
    tag    => 'neutron-service',
  }

  if ($resource_provider_bandwidths != []) {
    $res_prov_bw_map_str = join(any2array($resource_provider_bandwidths), ',')
    neutron_sriov_agent_config {
      'sriov_nic/resource_provider_bandwidths': value => $res_prov_bw_map_str;
    }
  }

}