windows_network chef Cookbook

This cookbook will configure the network interfaces on Windows

It looks into a databag for IP information and sets it if it's not set as specified. It supports two different formats to store the IP configuration, to support logical and the 'udev' (a proprietary) format.

Now with LWRP support for those one offs, like vagrant.

Resource/Provider

dnsserver

Actions

• :set: sets a dnsserver address for an adapter

Attribute Parameters

• name: name attribute. Name of the interface. Example: "Local Area Connection"
• server_addresses: IPv4 address of dns server. NOTE: Single value, mutliple dns servers are not currently supported.
• address_family: Specifies the address family. The acceptable values for this parameter are: IPv4 or IPv6. NOTE: Only IPv4 is supported currently.
• reset_server_addresses: Boolean - Resets the DNS server IP addresses to their default value.

Examples

# Set dns server to 192.168.1.1 for interface Ethernet
windows_network_dnsserver 'Ethernet' do
  action :set
  server_addresses "192.168.1.1"

# Reset dns server for the interface Local Area Connection
windows_network_dnsserver 'Local Area Connection' do
  reset_server_addresses true
end

Requirements

This cookbook needs a data bag called 'servers' with an item named as your hostname. It also uses win_domain for fallback information.

####Datatype 1 (default)

#####data bag [servers][hostname]

{
  "id": "mycomputername",
  "interfaces": [
    {
      "name":     "Local network",
      "mac":      "00:AC:21:BC:F0:E0", 
      "address":  "10.1.0.123",
      "netmask":  "255.255.255.0",
      "gateway":  "10.1.0.1",
      "dns-nameservers": "10.1.0.231,10.111.0.231",
      "dns-search": "mydomain.local"
    }
  ]
}

or for more than one interface: (here with multipe ip's)

{
  "id": "mycomputername",
  "interfaces": [
    {
      "name":     "Local network",
      "mac":      "00:AC:21:BC:F0:E1",  
      "address":  "dhcp"
    },
    {
      "name":     "Local network",
      "mac":      "00:AC:21:BC:F0:E0", 
      "address":  "10.1.0.123,10.1.0.124",
      "netmask":  "255.255.255.0,255.255.255.0",
      "gateway":  "10.1.0.1",
      "dns-nameservers": "10.1.0.231,10.111.0.231",
      "dns-search": "mydomain.local"
    }
  ]
}

####Datatype 2 (aka udev)

#####data bag [servers][hostname] Note that MAC addresses need to be in lowercase

{
  "id": "mycomputername",
  "def_gw": "192.168.1.195",
  "net": {
    "eth4": "00:20:56:9a:63:a1",
    "eth0": "00:20:56:9a:13:ee",
    "eth2": "00:20:56:9a:3b:b9",
    "eth1": "00:20:56:9a:40:08"
  },
  "ip": {
    "eth4": "192.168.4.127",
    "eth0": "192.168.3.228",
    "eth2": "192.168.2.228",
    "eth1": "192.168.1.199"
  },
  "netmasks": {
    "eth4": "nil",
    "eth0": "255.255.255.192",
    "eth2": "255.255.255.192",
    "eth1": "255.255.255.192"
  },
  "broadcasts": {
    "eth4": "nil",
    "eth0": "192.168.3.255",
    "eth2": "192.168.2.255",
    "eth1": "192.168.1.255"
  },
  "networks": {
    "eth4": "nil",
    "eth0": "192.168.3.192",
    "eth2": "192.168.2.192",
    "eth1": "192.168.1.192"
  },
  "naming": {
    "build": "00:20:56:9a:63:a1",
    "admin": "00:20:56:9a:13:ee",
    "back": "00:20:56:9a:3b:b9",
    "front": "00:20:56:9a:40:08"
  },
  "dns": {
    "dns1": "192.168.99.121",
    "dns2": "192.168.98.97"
  }
}

####Environment (optional)

{
  "name": "office",
  "override_attributes": {
    "win_domain": {
      "DNS1": "10.1.0.231",
      "DNS2": "10.1.0.231",
      "DomainDNSName": "mydomain.local"
    }
  }
}

Usage

1 Include cookbook in recipe: recipe/default.rb

include_recipe "windows_network"

Optionally override attributes

node.override['windows_network']['databag_name'] = "udev" 
node.override['windows_network']['datatype'] = 2 

2 Include version in metadata: metadata.rb

depends 'windows_network', '>= 0.1.0'

3 Add data bag servers as described above section

4 (optional) Add Environment variables under win_domain

Notes

• If there is only one NIC and only one config in the data bag, then this config will be used.
• If there is only one NIC and only one config in the data bag, then the mac entry can be omitted.
• You can specify "dhcp" as address and the NIC will be configure for DHCP.

Todo

• Handle multiple IP addresses per interface
• Handle routes per interface

Contributing

1. Fork the repository on Github
2. Create a named feature branch (i.e. add-new-recipe)
3. Write you change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request

License and Authors

Authors:

Christoffer Järnåker, Proxmea BV

Christoffer Järnåker, Schuberg Philis, 2014

Derek Groh

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