bond resource

Use the bond Chef InSpec audit resource to test a logical, bonded network interface (i.e. “two or more network interfaces aggregated into a single, logical network interface”). On Linux platforms, any value in the /proc/net/bonding directory may be tested.

Availability

Install

This resource is distributed with Chef InSpec and is automatically available for use.

Version

This resource first became available in v1.0.0 of InSpec.

Syntax

A bond resource block declares a bonded network interface, and then specifies the properties of that bonded network interface to be tested:

describe bond('name') do
  it { should exist }
end

where

• 'name' is the name of the bonded network interface
• { should exist } is a valid matcher for this resource

Properties

content

The content property returns the contents in the file that defines the bonded network interface. The values of the content property are arbitrary.

its('content') { should match('value') }

interfaces

The interfaces property tests if the named secondary interfaces are available.

its('interfaces') { should eq ['eth0', 'eth1', ...] }

mode

The mode property returns the Bonding Mode.

its('mode') { should eq 'IEEE 802.3ad Dynamic link aggregation' }

params

The params property returns arbitrary parameters for the bonded network interface.

its('params') { should eq 'value' }

Examples

Test if eth0 is a secondary interface for bond0

describe bond('bond0') do
  it { should exist }
  it { should have_interface 'eth0' }
end

Test parameters for bond0

describe bond('bond0') do
  its('mode') { should eq 'IEEE 802.3ad Dynamic link aggregation' }
  its('params') { should have_key 'Transmit Hash Policy' }
  its('params') { should include 'Transmit Hash Policy' => 'layer3+4 (1)' }
  its('params') { should have_key 'MII Status' }
  its('params') { should include 'MII Status' => 'up' }
end

Matchers

For a full list of available matchers, see our Universal Matchers page.

This resource has the following special matchers.

exist

The exist matcher tests if the bonded network interface is available:

it { should exist }

have_interface

The have_interface matcher tests if the bonded network interface has one (or more) secondary interfaces:

it { should have_interface }