1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
#
# Author:: Jason K. Jackson (jasonjackson@gmail.com)
# Author:: Tyler Cloke (<tyler@chef.io>)
# Copyright:: Copyright 2009-2016, Jason K. Jackson
# License:: Apache License, Version 2.0
#
# 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.
#
require_relative "../resource"
class Chef
class Resource
class Ifconfig < Chef::Resource
provides :ifconfig
description "Use the **ifconfig** resource to manage interfaces on Unix and Linux systems. Note: This resource requires the ifconfig binary to be present on the system and may require additional packages to be installed first. On Ubuntu 18.04 or later you will need to install the `ifupdown` package, which disables the built in Netplan functionality. Warning: This resource will not work with Fedora release 33 or later."
examples <<~DOC
**Configure a network interface with a static IP**
```ruby
ifconfig '33.33.33.80' do
device 'eth1'
end
```
will create the following interface configuration:
```
iface eth1 inet static
address 33.33.33.80
```
**Configure an interface to use DHCP**
```ruby
ifconfig 'Set eth1 to DHCP' do
device 'eth1'
bootproto 'dhcp'
end
```
will create the following interface configuration:
```
iface eth1 inet dhcp
```
**Update a static IP address with a boot protocol**
```ruby
ifconfig "33.33.33.80" do
bootproto "dhcp"
device "eth1"
end
```
will update the interface configuration from static to dhcp:
```
iface eth1 inet dhcp
address 33.33.33.80
```
DOC
state_attrs :inet_addr, :mask
default_action :add
allowed_actions :add, :delete, :enable, :disable
property :target, String,
name_property: true,
description: "The IP address that is to be assigned to the network interface. If not specified we'll use the resource's name."
property :hwaddr, String,
description: "The hardware address for the network interface."
property :mask, String,
description: "The decimal representation of the network mask. For example: `255.255.255.0`."
property :family, String, default: "inet",
introduced: "14.0",
description: "Networking family option for Debian-based systems; for example: `inet` or `inet6`."
property :inet_addr, String,
description: "The Internet host address for the network interface."
property :bcast, String,
description: "The broadcast address for a network interface. On some platforms this property is not set using ifconfig, but instead is added to the startup configuration file for the network interface."
property :mtu, String,
description: "The maximum transmission unit (MTU) for the network interface."
property :metric, String,
description: "The routing metric for the interface."
property :device, String,
identity: true,
description: "The network interface to be configured."
property :onboot, String,
description: "Bring up the network interface on boot."
property :network, String,
description: "The address for the network interface."
property :bootproto, String,
description: "The boot protocol used by a network interface."
property :onparent, String,
description: "Bring up the network interface when its parent interface is brought up."
property :ethtool_opts, String,
introduced: "13.4",
description: "Options to be passed to ethtool(8). For example: `-A eth0 autoneg off rx off tx off`."
property :bonding_opts, String,
introduced: "13.4",
description: "Bonding options to pass via `BONDING_OPTS` on RHEL and CentOS. For example: `mode=active-backup miimon=100`."
property :master, String,
introduced: "13.4",
description: "Specifies the channel bonding interface to which the Ethernet interface is linked."
property :slave, String,
introduced: "13.4",
description: "When set to `yes`, this device is controlled by the channel bonding interface that is specified via the `master` property."
property :vlan, String,
introduced: "14.4",
description: "The VLAN to assign the interface to."
property :gateway, String,
introduced: "14.4",
description: "The gateway to use for the interface."
property :bridge, String,
introduced: "16.7",
description: "The bridge interface this interface is a member of on Red Hat based systems."
end
end
end
|
