Cookbook network_interfaces_v2

A cookbook containing providers for defining network interfaces.

Supported Platforms

• RHEL 6.x (I do use on RHEL 7.x but testing coverage here does not cover RHEL 7.x currently)
• Ubuntu >= 12.x
• Windows 2008R2 (Works if PowerShell/WMF 4.0 is present (can be installed via powershell_installer recipe - WARNING: NOT FULLY TESTED! - WITHOUT SUPPORT ON THIS MOMENT))
• Windows 2012R2

Usage

Add depends 'network_interfaces_v2' to your cookbook metadata.rb file. This will give you access to the providers documented below.

Recipes

default

Does nothing and does not need to be included.

powershell_installer

Installs WMF 4.0 for Windows 2008 R2. This cookbook can work with this Windows version, since you use this cookbook before.

network_interface

Provider for managing network interfaces.

Attributes

• device (REQUIRED) - Device name
• onboot (default: true) - Wether or not to online device on boot
• bootproto (default: 'dhcp') - Device protocol
• bond_mode - Bonding mode
• address - IP address
• netmask - Netmask
• gateway - Gateway IP address
• broadcast - Broadcast address
• mtu - MTU
• hw_address - MAC address of device to configure
• vlan
• debian - VLAN device interface
• RHEL - true/false if device defined is a VLAN interface
• Win - Integer VlanID to tag to defined device
• post_up - Post up command to run after modifying the interface
• reload (default: true) - Wether or not to reload the device on config changes
• reload_type (default: :immediately) - When to reload device on config changes
• cookbook (default: 'network_interfaces_v2') - Cookbook to look for template files in
• source (default: 'ifcfg.erb') - Template file to use for interface config

Debian Only Attributes

• bridge_stp (true/false) - Wether to enable/disable bridge STP. Applies to debian only.
• bridge_ports - Array of interfaces to add to defined bridge
• metric -
• bond_slaves - Array of interfaces to add to defined bond
• pre_up (default: 'sleep 2')- Pre up command
• up - Up command
• post_up - Post up command
• pre_down - Pre down command
• down - Down command
• post_down - Post down command
• custom - Hash of extra attributes to put in device config

RHEL Only Attributes

• prefix - Netmask length (e.g. 24 for 255.255.255.0)
• dns - Array of DNS servers
• type - Protocol Type. Applies to RHEL only.
• bond_master - Device that is the bond master for defined device. Applies to RHEL only.
• nm_controlled (default: false)- If device should be controlled by network manager.
• type (default: 'Ethernet') -
• ipv6init - true/false
• nozeroconf - true/false
• userctl - true/false
• peerdns - true/false
• bridge_device - Bridge to add defined interface to
• devicetype - Set the type of device (e.g. 'ovs')
• ovs_bridge - OVS Bridge to bind ovs port to (primarily used when type is set as 'OVSPort')
• dns_domain - DNS domain

Windows Only Attributes

• hw_address - Can be used to define what device to manage
• index - Can be used to define what device to manage
• dns - Array of DNS servers
• dns_domain - DNS domain
• ddns - true/false dynamic dns registration
• netbios - Enable/Disable netbios on the interface. Valid values: true, false, 'dhcp'

Providers

Long name	Short name
Chef::Provider::NetworkInterface::Rhel	rhel_network_interface
Chef::Provider::NetworkInterface::Debian	debian_network_interface
Chef::Provider::NetworkInterface::Win	win_network_interface

Examples

Basic example:

network_interface 'eth1' do
  bootproto 'static'
  address '10.12.10.11'
  netmask '255.255.255.0'
  gateway '10.12.10.1'
end

Two interface DHCP bond0 on rhel family

network_interface 'eth1' do
  bootproto 'none'
  bond_master 'bond0'
end

network_interface 'eth2' do
  bootproto 'none'
  bond_master 'bond0'
end

network_interface 'bond0' do
  bond_mode 'mode=1 miimon=100'
end

Two interface DHCP bond0 on debian family

network_interface 'bond0' do
  bond_slaves ['eth1', 'eth2']
  bond_mode '0'
end

network_interface 'eth1' do
  bootproto 'manual'
  bond_master 'bond0'
end

network_interface 'eth2' do
  bootproto 'manual'
  bond_master 'bond0'
end

On windows manage device with MAC '00-25-B5-5B-00-25', name it 'eth2', make it DHCP (default bootproto) and VLAN tagged to VLAN 12

network_interface 'eth2' do
  hw_address '00-25-B5-5B-00-25'
  vlan 12
end

Testing

bundle exec rubocop
bundle exec foodcritic -f any -X spec .
bundle exec rspec --color --format progress
bundle exec kitchen test

License and Authors

Author:: Jacob McCann (jacob.mccann2@target.com)

Based on work from https://github.com/redguide/network_interfaces

Copyright:: 2015, Target Corporation

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.