]> git.donarmstrong.com Git - dsa-puppet.git/blobdiff - 3rdparty/modules/neutron/manifests/agents/ml2/ovs.pp
try again, with puppetforge modules, correctly included now
[dsa-puppet.git] / 3rdparty / modules / neutron / manifests / agents / ml2 / ovs.pp
diff --git a/3rdparty/modules/neutron/manifests/agents/ml2/ovs.pp b/3rdparty/modules/neutron/manifests/agents/ml2/ovs.pp
new file mode 100644 (file)
index 0000000..11753e8
--- /dev/null
@@ -0,0 +1,249 @@
+#
+# Copyright (C) 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::ovs
+#
+# Setups OVS 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
+#
+# [*bridge_uplinks*]
+#   (optional) List of interfaces to connect to the bridge when doing
+#   bridge mapping.
+#   Defaults to empty list
+#
+# [*bridge_mapping*]
+#   (optional) List of <physical_network>:<bridge>
+#   Defaults to empty list
+#
+# [*integration_bridge*]
+#   (optional) Integration bridge in OVS
+#   Defaults to 'br-int'
+#
+# [*enable_tunneling*]
+#   (optional) Enable or not tunneling
+#   Defaults to false
+#
+# [*tunnel_types*]
+#   (optional) List of types of tunnels to use when utilizing tunnels,
+#   either 'gre' or 'vxlan'.
+#   Defaults to false
+#
+# [*local_ip*]
+#   (optional) Local IP address of GRE tunnel endpoints.
+#   Required when enabling tunneling
+#   Defaults to false
+#
+# [*tunnel_bridge*]
+#   (optional) Bridge used to transport tunnels
+#   Defaults to 'br-tun'
+#
+# [*vxlan_udp_port*]
+#   (optional) The UDP port to use for VXLAN tunnels.
+#   Defaults to '4789'
+#
+# [*polling_interval*]
+#   (optional) The number of seconds the agent will wait between
+#   polling for local device changes.
+#   Defaults to '2"
+#
+# [*l2_population*]
+#   (optional) Extension to use alongside ml2 plugin's l2population
+#   mechanism driver.
+#   Defaults to false
+#
+# [*arp_responder*]
+#   (optional) Enable or not the ARP responder.
+#   Recommanded when using l2 population mechanism driver.
+#   Defaults to false
+#
+# [*firewall_driver*]
+#   (optional) Firewall driver for realizing neutron security group function.
+#   Defaults to 'neutron.agent.linux.iptables_firewall.OVSHybridIptablesFirewallDriver'.
+#
+# [*enable_distributed_routing*]
+#   (optional) Set to True on L2 agents to enable support
+#   for distributed virtual routing.
+#   Defaults to false
+#
+class neutron::agents::ml2::ovs (
+  $package_ensure             = 'present',
+  $enabled                    = true,
+  $bridge_uplinks             = [],
+  $bridge_mappings            = [],
+  $integration_bridge         = 'br-int',
+  $enable_tunneling           = false,
+  $tunnel_types               = [],
+  $local_ip                   = false,
+  $tunnel_bridge              = 'br-tun',
+  $vxlan_udp_port             = 4789,
+  $polling_interval           = 2,
+  $l2_population              = false,
+  $arp_responder              = false,
+  $firewall_driver            = 'neutron.agent.linux.iptables_firewall.OVSHybridIptablesFirewallDriver',
+  $enable_distributed_routing = false,
+) {
+
+  include neutron::params
+  require vswitch::ovs
+
+  if $enable_tunneling and ! $local_ip {
+    fail('Local ip for ovs agent must be set when tunneling is enabled')
+  }
+
+  if $enable_distributed_routing and ! $l2_population {
+    fail('L2 population must be enabled when DVR is enabled')
+  }
+
+  Neutron_plugin_ml2<||> ~> Service['neutron-ovs-agent-service']
+
+  if ($bridge_mappings != []) {
+    # bridge_mappings are used to describe external networks that are
+    # *directly* attached to this machine.
+    # (This has nothing to do with VM-VM comms over neutron virtual networks.)
+    # Typically, the network node - running L3 agent - will want one external
+    # network (often this is on the control node) and the other nodes (all the
+    # compute nodes) will want none at all.  The only other reason you will
+    # want to add networks here is if you're using provider networks, in which
+    # case you will name the network with bridge_mappings and add the server's
+    # interfaces that are attached to that network with bridge_uplinks.
+    # (The bridge names can be nearly anything, they just have to match between
+    # mappings and uplinks; they're what the OVS switches will get named.)
+
+    # Set config for bridges that we're going to create
+    # The OVS neutron plugin will talk in terms of the networks in the bridge_mappings
+    $br_map_str = join($bridge_mappings, ',')
+    neutron_plugin_ml2 {
+      'ovs/bridge_mappings': value => $br_map_str;
+    }
+    neutron::plugins::ovs::bridge{ $bridge_mappings:
+      before => Service['neutron-ovs-agent-service'],
+    }
+    neutron::plugins::ovs::port{ $bridge_uplinks:
+      before => Service['neutron-ovs-agent-service'],
+    }
+  }
+
+  neutron_plugin_ml2 {
+    'agent/polling_interval':           value => $polling_interval;
+    'agent/l2_population':              value => $l2_population;
+    'agent/arp_responder':              value => $arp_responder;
+    'agent/enable_distributed_routing': value => $enable_distributed_routing;
+    'ovs/integration_bridge':           value => $integration_bridge;
+  }
+
+  if ($firewall_driver) {
+    neutron_plugin_ml2 { 'securitygroup/firewall_driver':
+      value => $firewall_driver
+    }
+  } else {
+    neutron_plugin_ml2 { 'securitygroup/firewall_driver': ensure => absent }
+  }
+
+  vs_bridge { $integration_bridge:
+    ensure => present,
+    before => Service['neutron-ovs-agent-service'],
+  }
+
+  if $enable_tunneling {
+    vs_bridge { $tunnel_bridge:
+      ensure => present,
+      before => Service['neutron-ovs-agent-service'],
+    }
+    neutron_plugin_ml2 {
+      'ovs/enable_tunneling': value => true;
+      'ovs/tunnel_bridge':    value => $tunnel_bridge;
+      'ovs/local_ip':         value => $local_ip;
+    }
+
+    if size($tunnel_types) > 0 {
+      neutron_plugin_ml2 {
+        'agent/tunnel_types': value => join($tunnel_types, ',');
+      }
+    }
+    if 'vxlan' in $tunnel_types {
+      validate_vxlan_udp_port($vxlan_udp_port)
+      neutron_plugin_ml2 {
+        'agent/vxlan_udp_port': value => $vxlan_udp_port;
+      }
+    }
+  } else {
+    neutron_plugin_ml2 {
+      'ovs/enable_tunneling': value  => false;
+      'ovs/tunnel_bridge':    ensure => absent;
+      'ovs/local_ip':         ensure => absent;
+    }
+  }
+
+
+  if $::neutron::params::ovs_agent_package {
+    Package['neutron-ovs-agent'] -> Neutron_plugin_ml2<||>
+    package { 'neutron-ovs-agent':
+      ensure  => $package_ensure,
+      name    => $::neutron::params::ovs_agent_package,
+    }
+  } else {
+    # Some platforms (RedHat) do not provide a separate
+    # neutron plugin ovs agent package. The configuration file for
+    # the ovs agent is provided by the neutron ovs plugin package.
+    Package['neutron-ovs-agent'] -> Neutron_plugin_ml2<||>
+    Package['neutron-ovs-agent'] -> Service['ovs-cleanup-service']
+
+    if ! defined(Package['neutron-ovs-agent']) {
+      package { 'neutron-ovs-agent':
+        ensure  => $package_ensure,
+        name    => $::neutron::params::ovs_server_package,
+      } ->
+      # https://bugzilla.redhat.com/show_bug.cgi?id=1087647
+      # Causes init script for agent to load the old ovs file
+      # instead of the ml2 config file.
+      file { '/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini':
+        ensure => link,
+        target => '/etc/neutron/plugins/ml2/ml2_conf.ini'
+      } ~> Service<| title == 'neutron-ovs-agent-service' |>
+    }
+  }
+
+  if $enabled {
+    $service_ensure = 'running'
+  } else {
+    $service_ensure = 'stopped'
+  }
+
+  service { 'neutron-ovs-agent-service':
+    ensure  => $service_ensure,
+    name    => $::neutron::params::ovs_agent_service,
+    enable  => $enabled,
+    require => Class['neutron'],
+  }
+
+  if $::neutron::params::ovs_cleanup_service {
+    Package['neutron-ovs-agent'] -> Service['ovs-cleanup-service']
+    service { 'ovs-cleanup-service':
+      name   => $::neutron::params::ovs_cleanup_service,
+      enable => $enabled,
+    }
+  }
+}