interfaces resource

[edit on GitHub]

Use the interfaces Chef InSpec audit resource to test the properties of multiple network interfaces on the system.

Syntax

An interfaces resource block may take no arguments, in which case it will list all interfaces:

describe interfaces do
  its('names') { should include 'eth0' }
end

An interfaces resource block may take a where clause, filtering on a Filter Criterion:

# All eth- interfaces
describe interfaces.where(name: /^eth\d+/)
  its('names') { should include 'eth0' }
end

Like any Chef InSpec resource, you may also use it for data lookup instead of testing:

# We are an IPv6 shop
interfaces.where(name: /^eth/).names do |name|
  describe interface(name) do
    it { should have_ipv6_address }
  end
end

# Obtain the machine's main IP address
my_ip = interfaces.ipv4_address

Filter Criteria

name

String. The name of an interface.

Properties

count

The count property returns an Integer describing how many interfaces matched.

its(“count”) { should eq 6 }

ipv4_address

Attempts to guess the “first” “real” IPv4 address on any interface. Looks for interfaces that are up and have IPv4 addresses assigned, then tries to filter out loopback, management (10/8) and local (192.168/16) IP addresses, returning the best of of those that it can; you may still get nil, or a loopback address. Note that if the machine is behind NAT this will not be the external IP address; use the http resource to query an IP lookup service for that.

its(‘ipv4_address’) { should_not eq ‘127.0.0.1’ }

names

The names property returns an Array of Strings representing the names of the interfaces.

its(“names”) { should include “eth0” }

Matchers

For a full list of available universal matchers, please visit our matchers page.

exist

The exist matcher tests true if at least one interface exists on the system. This is almost always the case.

it { should exist }

© Chef Software, Inc.
Licensed under the Creative Commons Attribution 3.0 Unported License.
The Chef™ Mark and Chef Logo are either registered trademarks/service marks or trademarks/servicemarks of Chef, in the United States and other countries and are used with Chef Inc's permission.
We are not affiliated with, endorsed or sponsored by Chef Inc.
https://docs.chef.io/inspec/resources/interfaces/