arista-eos 1.1.0

data/lib/puppet/type/eos_ipinterface.rb

@@ -0,0 +1,116 @@
+#
+# 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.
+#
+
+require 'puppet_x/eos/utils/helpers'
+
+Puppet::Type.newtype(:eos_ipinterface) do
+  @doc = <<-EOS
+    This type provides management of logical IP interfaces configured
+    in EOS.  It provides configuration of IPv4 properties on physical
+    interfaces and logical virtual interfaces.
+  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.
+    EOS
+  end
+
+  # Properties (state management)
+
+  newproperty(:address) do
+    desc <<-EOS
+      The address property configures the IPv4 address on the
+      specified interface.  The address value is configured using
+      address/mask format.
+
+      For example
+
+        address => 192.168.10.16/24
+    EOS
+
+    validate do |value|
+      begin
+        IPAddr.new value
+      rescue ArgumentError => exc
+        raise "value #{value.inspect} is invalid, #{exc.message}"
+      end
+    end
+  end
+
+  newproperty(:helper_addresses, array_matching: :all) do
+    desc <<-EOS
+      The helper_addresses property configures the list of IP
+      helper addresses on the specified interface.  IP helper
+      addresses configure a list of forwarding address to send
+      send broadcast traffic to as unicast, typically used to
+      assist DHCP relay.
+
+      Helper addresses are configured using dotted decimal
+      notation.  For example
+
+        helper_addresses => ['192.168.10.254', '192.168.11.254']
+    EOS
+
+    validate do |value|
+      unless value =~ IPADDR_REGEXP
+        fail "value #{value.inspect} is invalid, must be an IP address"
+      end
+    end
+  end
+
+  newproperty(:mtu) do
+    desc <<-EOS
+      The mtu property configures the IP interface MTU value
+      which specifies the largest IP datagram that can pass
+      over the interface without fragementation.  The MTU value
+      is specified in bytes and accepts an integer in the range of
+      68 to 9214.
+    EOS
+
+    munge do |value|
+      Integer(value)
+    end
+
+    validate do |value|
+      unless value.to_i.between?(68, 9214)
+        fail "value #{value.inspect} must be in the range of 68 and 9214"
+      end
+    end
+  end
+end

data/lib/puppet/type/eos_mlag.rb

@@ -0,0 +1,133 @@
+#
+# 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
+
+require 'puppet_x/eos/utils/helpers'
+
+Puppet::Type.newtype(:eos_mlag) do
+  @doc = <<-EOS
+    This type manages the global MLAG instance on EOS nodes.  It
+    provides configuration for global MLAG configuration parameters.
+  EOS
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter identifies the global MLAG instance for
+      configuration and should be configured as 'settings'.  All
+      other values for name will be siliently ignored by the eos_mlag
+      provider.
+    EOS
+    isnamevar
+  end
+
+  # Properties (state management)
+
+  newproperty(:domain_id) do
+    desc <<-EOS
+      The domain_id property configures the MLAG domain-id value for
+      the global MLAG configuration instance.  The domain-id setting
+      identifies the domain name for the MLAG domain. Valid values
+      include alphanumeric characters
+    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(:local_interface) do
+    desc <<-EOS
+      The local_interface property configures the MLAG local-interface
+      value for the global MLAG configuration instance.  The local-interface
+      setting specifies the VLAN SVI to send MLAG control traffic on.
+
+      Valid values must be a VLAN SVI identifier
+    EOS
+
+    validate do |value|
+      unless value =~ /^Vlan\d+$/
+        fail "value #{value.inspect} is invalid, must be a VLAN SVI"
+      end
+    end
+  end
+
+  newproperty(:peer_address) do
+    desc <<-EOS
+      The peer_address property configures the MLAG peer-address value
+      for the global MLAG configuration instance.  The peer-address setting
+      specifieds the MLAG peer control endpoint IP address.
+
+      The specified value must be a valid IP address
+    EOS
+
+    validate do |value|
+      unless value =~ IPADDR_REGEXP
+        fail "value #{value.inspect} is invalid, must be an IP address"
+      end
+    end
+  end
+
+  newproperty(:peer_link) do
+    desc <<-EOS
+      The peer_link property configures the MLAG peer-link value for the
+      glboal MLAG configuration instance.  The peer-link setting specifies
+      the interface used to communicate control traffic to the MLAG peer
+
+      The provided value must be a valid Ethernet or Port-Channel interface
+      identifer
+    EOS
+
+    validate do |value|
+      unless value =~ /^[Et|Po].+/
+        fail "value #{value.inspect} is invalid, must be a valid " \
+             'Ethernet or Port-Channel interface identifier'
+      end
+    end
+  end
+
+  newproperty(:enable) do
+    desc <<-EOS
+      The enable property configures the admininstrative state of the
+      global MLAG configuration.  Valid values for enable are:
+
+      * true - globally enables the MLAG configuration
+      * false - glboally disables the MLAG configuration
+    EOS
+
+    newvalues(:true, :false)
+  end
+end

data/lib/puppet/type/eos_mlag_interface.rb

@@ -0,0 +1,85 @@
+#
+# Copyright (c) 2015, 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_mlag_interface) do
+  @doc = <<-EOS
+    This type manages MLAG interfaces on the node used to establish
+    a valid MLAG with a peer switch.  The mlag_id parameter is required
+    for this type.
+  EOS
+
+  ensurable
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name property identifies the interface to be present
+      or absent from the MLAG interface list.  The interface must
+      be of type portchannel.
+
+      This property expectes the full interface identifier
+    EOS
+
+    validate do |value|
+      unless value =~ /^Port-Channel/
+        fail "value #{value.inspect} is invalid, must be a Port-Channel"
+      end
+    end
+  end
+
+  # Properties (state management)
+
+  newproperty(:mlag_id) do
+    desc <<-EOS
+      The mlag_id property assigns a MLAG ID to a Port-Channel interface
+      used for forming a MLAG with a peer switch.  Only one MLAG ID can
+      be associated with an interface.
+
+      Valid values are in the range of 1 to 2000
+
+      **Note**
+      Changing this value on an operational link will cause traffic
+      distruption
+    EOS
+
+    munge do |value|
+      Integer(value).to_i
+    end
+
+    validate do |value|
+      unless value.to_i.between?(1, 2_000)
+        fail "value #{value.inspect} is not between 1 and 2000"
+      end
+    end
+  end
+end

data/lib/puppet/type/eos_ntp_config.rb

@@ -0,0 +1,70 @@
+#
+# 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_ntp_config) do
+  @doc = <<-EOS
+    This type manages the nodes global NTP configuration settings.
+    It provides a configuration resource for setting global NTP
+    values
+  EOS
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter identifies the global NTP instance for
+      configuration and should be configured as 'settings'.  All
+      other values for name will be siliently ignored by the provider.
+    EOS
+    isnamevar
+  end
+
+  # Properties (state management)
+  #
+  newproperty(:source_interface) do
+    desc <<-EOS
+      The source interface property provides configuration management
+      of the NTP source-interface value.  The source interface value
+      configures the interface address to use as the source address
+      when sending NTP 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_ntp_server.rb

@@ -0,0 +1,52 @@
+#
+# 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_ntp_server) do
+  @doc = <<-EOS
+    This type manages the list of NTP servers.  It provides a
+    configuration resource for managing the list of NTP servers
+    used by the node.
+  EOS
+
+  ensurable
+
+  # Parameters
+
+  newparam(:name) do
+    desc <<-EOS
+      The name parameter configures the NTP server list by
+      adding or removing NTP server entries.  The value can be
+      configured as either the host IP address or the fully qualified
+      domain name of the desired NTP server.
+    EOS
+  end
+end