iis-lb

This cookbook configures IIS as a simple web load-balancer by creating an IIS Server Farm. It also allows you to pass a node['iis-lb']['members'] hash to add servers to the said server farm.

DISCLAIMER

This cookbook is used to help demonstrate the wrapper-cookbook pattern, attribute precedence and search in Chef Essentials training for Windows. This cookbook does NOT describe the definitive pattern for configuring IIS as a web load-balancer. Use at your own risk.

Platforms

This cookbook was tested on:

• Windows Server 2012 R2

Usage

Adding recipe[iis-lb::default] to your Windows Server's run_list will install all the necessary components and create an IIS Server Farm myServerFarm. This will also add two servers to the Server Farm, based on the node['iis-lb']['members'] hash. One should override this hash to add their own servers to the farm, such as in this example wrapper recipe:

node.default['iis-lb']['members'] = [
  {
    'address' => 'localhost',
    'weight' => 100,
    'port' => 4000,
    'ssl_port' => 4000
  },
  {
    'address' => '127.0.0.1',
    'weight' => 100,
    'port' => 4001,
    'ssl_port' => 4001
  }]

include_recipe 'iis-lib::default'

The recipe[iis-lb::sweep] will remove the Server Farm myServerFarm from your IIS configuration.

Dependencies

This cookbook depends on the following Community Cookbooks:

• windows
• webpi
• iis