arista-eos 1.1.0

data/guide/types.rst

@@ -0,0 +1,44 @@
+.. comment
+   # Generate typedoc.rst from the repo-root with the following commands:
+   bundle exec puppet doc -r type \
+   | awk '/This page/{flag=1}/augeas/{flag=0}/eos_/{flag=1}/ exec/{flag=0}/\*This page/{flag=1}flag' \
+   | pandoc --from=markdown --to=rst --output=- \
+   > guide/typedoc.rst
+
+Types
+=====
+
+.. contents::
+   :local:
+   :depth: 2
+
+Getting to know the Types
+-------------------------
+
+There are a number of ways to browse the available EOS types::
+
+  $ puppet resource --types | grep eos
+  $ puppet describe eos_vlan
+
+Display the current state of a type:
+
+.. code-block:: puppet
+
+  Arista#bash sudo puppet resource eos_vlan
+  eos_vlan { '1':
+    ensure    => 'present',
+    enable    => 'true',
+    vlan_name => 'default',
+  }
+  eos_vlan { '123':
+    ensure    => 'present',
+    enable    => 'true',
+    vlan_name => 'VLAN0123',
+  }
+  eos_vlan { '300':
+    ensure    => 'present',
+    enable    => 'true',
+    vlan_name => 'ztp_bootstrap',
+  }
+
+.. include:: typedoc.rst

data/lib/eos.rb

@@ -0,0 +1,8 @@
+require 'puppet_x/eos/version'
+require 'puppet_x/eos/autoload'
+require 'puppet_x/eos/eapi'
+
+##
+# eos namespace
+module Eos
+end

data/lib/eos/version.rb

@@ -0,0 +1,5 @@
+##
+# eos version
+module Eos
+  VERSION = '1.1.0'
+end

data/lib/puppet/provider/eos_acl_entry/default.rb

@@ -0,0 +1,122 @@
+#
+# 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.
+#
+require 'puppet/type'
+require 'pathname'
+
+module_lib = Pathname.new(__FILE__).parent.parent.parent.parent
+require File.join module_lib, 'puppet_x/eos/provider'
+
+Puppet::Type.type(:eos_acl_entry).provide(:eos) do
+  # Create methods that set the @property_hash for the #flush method
+  mk_resource_methods
+
+  # Mix in the api as instance methods
+  include PuppetX::Eos::EapiProviderMixin
+
+  # Mix in the api as class methods
+  extend PuppetX::Eos::EapiProviderMixin
+
+  def self.instances
+    acls = node.api('acl').getall
+    acls.each_with_object([]) do |(name, entries), arry|
+      entries.each_with_object([]) do |(seqno, attrs), _hsh|
+        provider_hash = { name: namevar(name, seqno), ensure: :present }
+        acltype = attrs[:acltype]
+        provider_hash[:acltype] = acltype ? acltype.to_sym : :standard
+        action = attrs[:action]
+        provider_hash[:action] = action ? action.to_sym : :deny
+        provider_hash[:srcaddr] = attrs[:srcaddr]
+        provider_hash[:srcprefixlen] = attrs[:srcprefixlen]
+        provider_hash[:log] = attrs[:log] ? :true : :false
+        arry << new(provider_hash)
+      end
+    end
+  end
+
+  def initialize(resource = {})
+    super(resource)
+    @property_flush = {}
+  end
+
+  def acltype=(value)
+    @property_flush[:acltype] = value
+  end
+
+  def action=(value)
+    @property_flush[:action] = value
+  end
+
+  def srcaddr=(value)
+    @property_flush[:srcaddr] = value
+  end
+
+  def srcprefixlen=(value)
+    @property_flush[:srcprefixlen] = value
+  end
+
+  def log=(value)
+    @property_flush[:log] = value
+  end
+
+  def exists?
+    @property_hash[:ensure] == :present
+  end
+
+  def create
+    @property_flush = resource.to_hash
+  end
+
+  def destroy
+    @property_flush = resource.to_hash
+  end
+
+  def flush
+    desired_state = @property_hash.merge!(@property_flush)
+    # Extract the acl name and seqno from the name
+    comp = desired_state[:name].split(':')
+    acl_name = comp[0]
+    desired_state[:seqno] = comp[1].to_i
+
+    api = node.api('acl')
+    case desired_state[:ensure]
+    when :present
+      api.update_entry(acl_name, desired_state)
+    when :absent
+      api.remove_entry(acl_name, desired_state[:seqno])
+    end
+    @property_hash = desired_state
+  end
+
+  def self.namevar(name, seqno)
+    "#{name}:#{seqno}"
+  end
+end

data/lib/puppet/provider/eos_command/default.rb

@@ -0,0 +1,61 @@
+#
+# 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/type'
+require 'puppet_x/eos/provider'
+
+Puppet::Type.type(:eos_command).provide(:eos) do
+  # Create methods that set the @property_hash for the #flush method
+  mk_resource_methods
+
+  # Mix in the api as instance methods
+  include PuppetX::Eos::EapiProviderMixin
+
+  # Mix in the api as class methods
+  extend PuppetX::Eos::EapiProviderMixin
+
+  def self.instances
+    []
+  end
+
+  def initialize(resource = {})
+    super(resource)
+    @property_flush = {}
+  end
+
+  def flush
+    if resource[:mode] == :config
+      node.config(resource[:commands])
+    else
+      node.enable(resource[:commands])
+    end
+  end
+end

data/lib/puppet/provider/eos_ethernet/default.rb

@@ -0,0 +1,96 @@
+#
+# 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/type'
+require 'pathname'
+
+module_lib = Pathname.new(__FILE__).parent.parent.parent.parent
+require File.join module_lib, 'puppet_x/eos/provider'
+
+Puppet::Type.type(:eos_ethernet).provide(:eos) do
+  # Create methods that set the @property_hash for the #flush method
+  mk_resource_methods
+
+  # Mix in the api as instance methods
+  include PuppetX::Eos::EapiProviderMixin
+
+  # Mix in the api as class methods
+  extend PuppetX::Eos::EapiProviderMixin
+
+  def self.instances
+    interfaces = node.api('interfaces').getall
+    interfaces.each_with_object([]) do |(name, attrs), arry|
+      next unless attrs[:type] == 'ethernet'
+      provider_hash = { name: name }
+      provider_hash[:enable] = attrs[:shutdown] ? :false : :true
+      provider_hash[:description] = attrs[:description]
+      provider_hash[:flowcontrol_send] = attrs[:flowcontrol_send].to_sym
+      provider_hash[:flowcontrol_receive] = attrs[:flowcontrol_receive].to_sym
+      arry << new(provider_hash)
+    end
+  end
+
+  def create
+    node.api('interfaces').create(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :present }
+    self.enable = resource[:enable] if resource[:enable]
+    self.description = resource[:description] if resource[:description]
+    self.flowcontrol_send = resource[:flowcontrol_send] \
+                            if resource[:flowcontrol_send]
+    self.flowcontrol_receive = resource[:flowcontrol_receive] \
+                               if resource[:flowcontrol_receive]
+  end
+
+  def destroy
+    node.api('interfaces').delete(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :absent }
+  end
+
+  def enable=(val)
+    node.api('interfaces').set_shutdown(resource[:name], value: val == :false)
+    @property_hash[:enable] = val
+  end
+
+  def description=(val)
+    node.api('interfaces').set_description(resource[:name], value: val)
+    @property_hash[:description] = val
+  end
+
+  def flowcontrol_send=(val)
+    node.api('interfaces').set_flowcontrol_send(resource[:name], value: val)
+    @property_hash[:flowcontrol_send] = val
+  end
+
+  def flowcontrol_receive=(val)
+    node.api('interfaces').set_flowcontrol_receive(resource[:name], value: val)
+    @property_hash[:flowcontrol_receive] = val
+  end
+end

data/lib/puppet/provider/eos_interface/default.rb

@@ -0,0 +1,89 @@
+#
+# 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/type'
+require 'pathname'
+
+module_lib = Pathname.new(__FILE__).parent.parent.parent.parent
+require File.join module_lib, 'puppet_x/eos/provider'
+
+Puppet::Type.type(:eos_interface).provide(:eos) do
+  # Create methods that set the @property_hash for the #flush method
+  mk_resource_methods
+
+  # Mix in the api as instance methods
+  include PuppetX::Eos::EapiProviderMixin
+
+  # Mix in the api as class methods
+  extend PuppetX::Eos::EapiProviderMixin
+
+  def self.instances
+    interfaces = node.api('interfaces').getall
+    interfaces.map do |(name, attrs)|
+      provider_hash = { name: name, ensure: :present }
+      provider_hash.merge!(attrs)
+      provider_hash[:enable] = attrs[:shutdown] ? :false : :true
+      new(provider_hash)
+    end
+  end
+
+  def enable=(val)
+    node.api('interfaces').set_shutdown(resource[:name], value: val == :false)
+    @property_hash[:enable] = val
+  end
+
+  def description=(val)
+    node.api('interfaces').set_description(resource[:name], value: val)
+    @property_hash[:description] = val
+  end
+
+  def exists?
+    @property_hash[:ensure] == :present
+  end
+
+  def create
+    if resource[:name] =~ /^[Et|Ma]/
+      fail 'Creating physical interfaces is not supported'
+    end
+    node.api('interfaces').create(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :present }
+    self.enable = resource[:enable] if resource[:enable]
+    self.description = resource[:description] if resource[:description]
+  end
+
+  def destroy
+    if resource[:name] =~ /^[Et|Ma]/
+      fail 'Destroying physical interfaces is not supported'
+    end
+    node.api('interfaces').delete(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :absent }
+  end
+end

data/lib/puppet/provider/eos_ipinterface/default.rb

@@ -0,0 +1,89 @@
+#
+# 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/type'
+require 'pathname'
+
+module_lib = Pathname.new(__FILE__).parent.parent.parent.parent
+require File.join module_lib, 'puppet_x/eos/provider'
+
+Puppet::Type.type(:eos_ipinterface).provide(:eos) do
+  # Create methods that set the @property_hash for the #flush method
+  mk_resource_methods
+
+  # Mix in the api as instance methods
+  include PuppetX::Eos::EapiProviderMixin
+
+  # Mix in the api as class methods
+  extend PuppetX::Eos::EapiProviderMixin
+
+  def self.instances
+    result = node.api('ipinterfaces').getall
+    result.map do |name, attrs|
+      provider_hash = { name: name, ensure: :present }
+      provider_hash.merge!(attrs)
+      new(provider_hash)
+    end
+  end
+
+  def address=(val)
+    node.api('ipinterfaces').set_address(resource['name'], value: val)
+    @property_hash[:address] = val
+  end
+
+  def helper_addresses=(val)
+    node.api('ipinterfaces').set_helper_addresses(resource['name'], value: val)
+    @property_hash[:helper_addresses] = val
+  end
+
+  def mtu=(val)
+    node.api('ipinterfaces').set_mtu(resource['name'], value: val)
+    @property_hash[:mtu] = val
+  end
+
+  def exists?
+    @property_hash[:ensure] == :present
+  end
+
+  def create
+    node.api('ipinterfaces').create(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :present }
+    self.address = resource[:address] if resource[:address]
+    self.mtu = resource[:mtu] if resource[:mtu]
+    self.helper_addresses = resource[:helper_addresses] \
+      if resource[:helper_addresses]
+  end
+
+  def destroy
+    node.api('ipinterfaces').delete(resource[:name])
+    @property_hash = { name: resource[:name], ensure: :absent }
+  end
+end