arista-eos 1.1.0

data/lib/puppet/type/eos_portchannel.rb

@@ -0,0 +1,189 @@
+#
+# Copyright (c) 2014, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#  Redistributions of source code must retain the above copyright notice,
+#  this list of conditions and the following disclaimer.
+#
+#  Redistributions in binary form must reproduce the above copyright
+#  notice, this list of conditions and the following disclaimer in the
+#  documentation and/or other materials provided with the distribution.
+#
+#  Neither the name of Arista Networks nor the names of its
+#  contributors may be used to endorse or promote products derived from
+#  this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+Puppet::Type.newtype(:eos_portchannel) do
+  @doc = <<-EOS
+    This type manages Port-Channel interface instances on Arista
+    EOS nodes.  It provides configuration resources for logical
+    Port-Channel instances and settings
+  EOS
+
+  ensurable
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter specifies the name of the Port-Channel
+      interface to configure.  The value must be the full
+      interface name identifier that corresponds to a valid
+      interface name in EOS.
+    EOS
+
+    validate do |value|
+      unless value =~ /^Port-Channel/
+        fail "value #{value.inspect} is invalid, must be a valid " \
+             'Port-Channel interface name'
+      end
+    end
+  end
+
+  # Properties (state management)
+
+  newproperty(:description) do
+    desc <<-EOS
+      The one line description to configure for the interface.  The
+      description can be any valid alphanumeric string including symbols
+      and spaces.
+
+      The default value for description is ''
+    EOS
+
+    validate do |value|
+      case value
+      when String then super(value)
+      else fail "value #{value.inspect} is invalid, must be a String."
+      end
+    end
+  end
+
+  newproperty(:enable) do
+    desc <<-EOS
+      The enable value configures the administrative state of the
+      specified interface.   Valid values for enable are:
+
+        * true - Administratively enables the interface
+        * false - Administratively disables the interface
+
+      The default value for enable is :true
+    EOS
+    newvalues(:true, :false)
+  end
+
+  newproperty(:lacp_mode) do
+    desc <<-EOS
+      The lacp_mode property configures the LACP operating mode of
+      the Port-Channel interface.  The LACP mode supports the following
+      valid values
+
+        * active - Interface is an active LACP port that transmits and
+            receives LACP negotiation packets.
+        * passive - Interface is a passive LACP port that only responds
+            to LACP negotiation packets.
+        * on - Interface is a static port channel, LACP disabled.
+
+      The default value for lacp_mode is :on
+    EOS
+
+    newvalues(:active, :passive, :on)
+  end
+
+  newproperty(:members, array_matching: :all) do
+    desc <<-EOS
+      The members property manages the Array of physical interfaces
+      that comprise the logical Port-Channel interface.  Each entry
+      in the members Array must be the full interface identifer of
+      a physical interface name.
+
+      The default value for members is []
+    EOS
+
+    validate do |value|
+      unless value =~ %r{^Ethernet\d(:\/\d+)?}
+        fail "value #{value.inspect} is invalid, must be an Ethernet interface"
+      end
+    end
+  end
+
+  newproperty(:minimum_links) do
+    desc <<-EOS
+      The minimum links property configures the port-channel min-links
+      value.  This setting specifies the minimum number of physical
+      interfaces that must be operationally up for the Port-Channel
+      interface to be considered operationally up.
+
+      Valid range of values for the minimum_links property are from
+      0 to 16.
+
+      The default value for minimum_links is 0
+    EOS
+
+    munge { |value| Integer(value) }
+
+    validate do |value|
+      unless value.to_i.between?(0, 16)
+        fail "value #{value.inspect} is not between 0 and 16"
+      end
+    end
+  end
+
+  newproperty(:lacp_fallback) do
+    desc <<-EOS
+      The lacp_fallback property configures the port-channel lacp
+      fallback setting in EOS for the specified interface.  This
+      setting accepts the following values
+
+        * static  - Fallback to static LAG mode
+        * individual - Fallback to individual ports
+        * disabled - Disable LACP fallback
+
+      The default value for lacp_fallback is :disabled
+    EOS
+
+    newvalues(:static, :individual, :disabled)
+  end
+
+  newproperty(:lacp_timeout) do
+    desc <<-EOS
+      The lacp_timeout property configures the port-channel lacp
+      timeout value in EOS for the specified interface.  The fallback
+      timeout configures the period an interface in fallback mode
+      remains in LACP mode without receiving a PDU.
+
+      The lacp_timeout value is configured in seconds with a valid
+      range betwee 1 and 100.
+
+      The default value is 90
+    EOS
+
+    munge do |value|
+      Integer(value)
+    end
+
+    # Validate each value is a valid timeout value
+    validate do |value|
+      unless value.to_i.between?(1, 100)
+        fail "value #{value.inspect} is not between 1 and 100"
+      end
+    end
+  end
+end

data/lib/puppet/type/eos_snmp.rb

@@ -0,0 +1,127 @@
+#
+# Copyright (c) 2014, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#  Redistributions of source code must retain the above copyright notice,
+#  this list of conditions and the following disclaimer.
+#
+#  Redistributions in binary form must reproduce the above copyright
+#  notice, this list of conditions and the following disclaimer in the
+#  documentation and/or other materials provided with the distribution.
+#
+#  Neither the name of Arista Networks nor the names of its
+#  contributors may be used to endorse or promote products derived from
+#  this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+Puppet::Type.newtype(:eos_snmp) do
+  @doc = <<-EOS
+    This type manages the global SNMP configuration instance on EOS
+    nodes.  It provides configuration resources for global SNMP
+    settings.
+  EOS
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter identifis the global SNMP instance for
+      configuration and should be configured as 'settings'.  All
+      other values for name will be silently ignored by the eos_snmp
+      provider.
+    EOS
+  end
+
+  # Properties (state management)
+
+  newproperty(:contact) do
+    desc <<-EOS
+      The contact property provides configuration management of the
+      SNMP contact value.  This setting provides informative text that
+      typically displays the name of a person or organization associated
+      with the SNMP agent.
+
+      The default value for contact is ''
+    EOS
+
+    validate do |value|
+      case value
+      when String
+        super(value)
+        validate_features_per_value(value)
+      else fail "value #{value.inspect} is invalid, must be a String."
+      end
+    end
+  end
+
+  newproperty(:location) do
+    desc <<-EOS
+      The location property provides configuration management of the
+      SNMP location value.  This setting typcially provides information
+      about the physical lcoation of the SNMP agent.
+
+      The default value for location is ''
+    EOS
+
+    validate do |value|
+      case value
+      when String
+        super(value)
+        validate_features_per_value(value)
+      else fail "value #{value.inspect} is invalid, must be a string."
+      end
+    end
+  end
+
+  newproperty(:chassis_id) do
+    desc <<-EOS
+      The chassis id propperty provides configuration management of
+      the SNMP chassis-id value.  This setting typically provides
+      information to uniquely identify the SNMP agent host.
+
+      The default value for chassis_id is ''
+    EOS
+
+    validate do |value|
+      case value
+      when String
+        super(value)
+        validate_features_per_value(value)
+      else fail "value #{value.inspect} is invalid, must be a string."
+      end
+    end
+  end
+
+  newproperty(:source_interface) do
+    desc <<-EOS
+      The source interface property provides configuration management
+      of the SNMP source-interface value.  The source interface value
+      configures the interface address to use as the source address
+      when sending SNMP packets on the network.
+
+      The default value for source_interface is ''
+    EOS
+
+    validate do |value|
+      unless value =~ /^[EMPLV]/
+        fail "value #{value.inspect} is invalid, must be an interface name"
+      end
+    end
+  end
+end

data/lib/puppet/type/eos_stp_interface.rb

@@ -0,0 +1,94 @@
+#
+# Copyright (c) 2014, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#  Redistributions of source code must retain the above copyright notice,
+#  this list of conditions and the following disclaimer.
+#
+#  Redistributions in binary form must reproduce the above copyright
+#  notice, this list of conditions and the following disclaimer in the
+#  documentation and/or other materials provided with the distribution.
+#
+#  Neither the name of Arista Networks nor the names of its
+#  contributors may be used to endorse or promote products derived from
+#  this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# encoding: utf-8
+
+Puppet::Type.newtype(:eos_stp_interface) do
+  @doc = <<-EOS
+    Manage Spanning Tree Protocol interface configuration.
+  EOS
+
+  # Parameters
+
+  newparam(:name) do
+    @doc = <<-EOS
+      The name parameter specifies the full interface identifier of
+      the Arista EOS interface to manage.  This value must correspond
+      to a valid interface identifier in EOS and must be either an
+      Ethernet or Port Channel interface.
+    EOS
+  end
+
+  # Properties (state management)
+
+  newproperty(:portfast) do
+    @doc = <<-EOS
+      The portfast property programs an STP port to immediately enter
+      forwarding state when they establish a link. PortFast ports
+      are included in spanning tree topology calculations and can
+      enter blocking state. Valid portfast values:
+
+      * true - Enable portfast for the interface
+      * false - Disable portfast for the interface (default value)
+    EOS
+    newvalues(:true, :false)
+  end
+
+  newproperty(:portfast_type) do
+    @doc = <<-EOS
+      Specifies the STP portfast mode type for the interface. A port
+      with edge type connect to hosts and transition to the forwarding
+      state when the link is established. An edge port that receives a
+      BPDU becomes a normal port. A port with network type connect only
+      to switches or bridges and support bridge assurance. Network ports
+      that connect to hosts or other edge devices transition ot the
+      blocking state. Valid portfast mode types:
+
+      * edge - Set STP port mode type to edge.
+      * network - Set STP port mode type to network.
+      * normal - Set STP port mode type to normal (default value)
+    EOS
+    newvalues(:edge, :network, :normal)
+  end
+
+  newproperty(:bpduguard) do
+    @doc = <<-EOS
+      Enable or disable the BPDU guard on a port. A BPDU guard-enabled
+      port is disabled when it receives a BPDU packet. Disabled ports
+      differ from blocked ports in that they are re-enabled only
+      through manual intervention. Valid BPDU guard values:
+
+      * true - Enable the BPDU guard for the interface
+      * false - Disable the BPDU guard for the interface (default value)
+    EOS
+    newvalues(:true, :false)
+  end
+end

data/lib/puppet/type/eos_switchport.rb

@@ -0,0 +1,150 @@
+#
+# Copyright (c) 2014, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#  Redistributions of source code must retain the above copyright notice,
+#  this list of conditions and the following disclaimer.
+#
+#  Redistributions in binary form must reproduce the above copyright
+#  notice, this list of conditions and the following disclaimer in the
+#  documentation and/or other materials provided with the distribution.
+#
+#  Neither the name of Arista Networks nor the names of its
+#  contributors may be used to endorse or promote products derived from
+#  this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+Puppet::Type.newtype(:eos_switchport) do
+  @doc = <<-EOS
+    This type provides a resource for configuring logical layer 2
+    switchports in EOS.  The resource provides configuration for both
+    access and trunk operating modes.
+
+    When creating a logical switchport interface, if the specified
+    physical interface was previously configured with an IP interface,
+    the logical IP interface will be removed.
+  EOS
+
+  ensurable
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter specifies the full interface identifier of
+      the Arista EOS interface to manage.  This value must correspond
+      to a valid interface identifier in EOS.
+
+      Only Ethernet and Port-Channel interfaces can be configured as
+      switchports.
+    EOS
+
+    validate do |value|
+      unless value =~ /^[Et|Po]/
+        fail 'value #{value.inspect} is invalid, must be of type ' \
+             'Ethernet or Port-Channel'
+      end
+    end
+  end
+
+  # Properties (state management)
+
+  newproperty(:mode) do
+    desc <<-EOS
+      The mode property configures the operating mode of the
+      logical switchport.  Suppport modes of operation include
+      access port or trunk port.  The default value for a new
+      switchport is access
+
+      * access - Configures the switchport mode to access
+      * trunk - Configures the switchport mode to trunk
+
+    EOS
+    newvalues(:access, :trunk)
+  end
+
+  newproperty(:trunk_allowed_vlans, array_matching: :all) do
+    desc <<-EOS
+      The trunk_allowed_vlans property configures the list of
+      VLAN IDs that are allowed to pass on the switchport operting
+      in trunk mode.  If the switchport is configured for access
+      mode, this property is configured but has no effect.
+
+      The list of allowed VLANs must be configured as an Array with
+      each entry in the valid VLAN range of 1 to 4094.
+
+      The default value for a new switchport is to allow all valid
+      VLAN IDs (1-4094).
+    EOS
+
+    munge do |value|
+      Integer(value)
+    end
+
+    validate do |value|
+      unless value.to_i.between?(1, 4_094)
+        fail "value #{value.inspect} is not between 1 and 4094"
+      end
+    end
+  end
+
+  newproperty(:trunk_native_vlan) do
+    desc <<-EOS
+      The trunk_native_vlan property specifies the VLAN ID to
+      be used for untagged traffic that enters the switchport
+      in trunk mode.  If the switchport is configured for access
+      mode, this value is configured but has no effect.  The value
+      must be an integer in the valid VLAN ID range of 1 to 4094.
+
+      The default value for the trunk_natve_vlan is 1
+    EOS
+
+    munge do |value|
+      Integer(value)
+    end
+
+    validate do |value|
+      unless value.to_i.between?(1, 4_094)
+        fail "value #{value.inspect} is not between 1 and 4094"
+      end
+    end
+  end
+
+  newproperty(:access_vlan) do
+    desc <<-EOS
+      The access_vlan property specifies the VLAN ID to be used
+      for untagged traffic that enters the switchport when configured
+      in access mode.  If the switchport is configured for trunk mode,
+      this value is configured but has no effect.  The value must be
+      an integer in the valid VLAN ID range of 1 to 4094.
+
+      The default value for the access_vlan is 1
+    EOS
+
+    munge do |value|
+      Integer(value)
+    end
+
+    validate do |value|
+      unless value.to_i.between?(1, 4_094)
+        fail "value #{value.inspect} is not between 1 and 4094"
+      end
+    end
+  end
+end