Development repository for Chef Cookbook webpi
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.delivery
.github Update Github PR template Oct 23, 2016
attributes Convert to a custom resource Apr 6, 2017
recipes
resources Use action_class instead of action_class.class_eval May 30, 2017
spec
test/cookbooks/test
.foodcritic
.gitignore Test with Local Delivery instead of Rake Mar 1, 2017
.kitchen.appveyor.yml Add a test recipe that actually test the resource Apr 6, 2017
.kitchen.yml Add a test recipe that actually test the resource Apr 6, 2017
Berksfile Add a test recipe that actually test the resource Apr 6, 2017
CHANGELOG.md
CONTRIBUTING.md Update docs Sep 8, 2015
Gemfile More cleanup of the maintainer files Sep 1, 2017
LICENSE
README.md Release 4.1.0 Mar 20, 2017
TESTING.md
appveyor.yml Skip the pester install in appveyer Mar 21, 2017
chefignore More cleanup of the maintainer files Sep 1, 2017
metadata.rb

README.md

webpi Cookbook

Build status Cookbook Version

Microsoft Web Platform Installer (WebPI) automates the installation of Microsoft's entire Web Platform. This cookbook makes it easy to get WebpiCmdLine.exe the lightweight CLI version of WebPI onto a Windows node. It also exposes a resource for installing WebPI products idempotently.

Requirements

Platforms

  • Windows 7
  • Windows Server 2008 R2
  • Windows 8, 8.1
  • Windows Server 2012 (R1, R2)

Chef

  • Chef 12.6+

Cookbooks

  • windows 2.0+

Attributes

  • node['webpi']['home'] - location to install WebPI files to. Default is %SYSTEMDRIVE%\webpi
  • node['webpi']['url'] - Path to download webpi zip.
  • node['webpi']['xmlpath'] - Optional path to custom xml file.
  • node['webpi']['install_method'] - Method of installing webpi via msi or zip. Default is msi.
  • node['webpi']['msi'] - Location of msi file to use.
  • node['webpi']['msi_package_name'] - Windows package name, found in registry, for msi. Defaults to "Microsoft Web Platform Installer 4.5"

Resource/Provider

webpi_product

Actions

  • :install: install a product using WebpiCmdLine

Attribute Parameters

  • product_id: name attribute. Specifies the ID of a product to install.
  • accept_eula: specifies that WebpiCmdline should auto-accept EULAs. Default is false.
  • returns: specifies the return value(s) expected for a successful installation. Can be a single integer or array of integers. Default is [0, 42]

Examples

Install IIS 7 Recommended Configuration (will install IIS 8 on Windows 2012 despite the name)

webpi_product 'IIS7' do
  accept_eula true
  action :install
end

Install Windows PowerShell 2.0

webpi_product 'PowerShell2' do
  accept_eula true
  action :install
end

Install Windows Azure Powershell 1.0 (will return a 3010 exit code to signify a successful installation that requires a reboot)

webpi_product 'WindowsAzurePowerShellGet' do
  accept_eula true
  action :install
  returns 3010
end

Usage

default

Downloads and unzips WebpiCmdLine.exe to the location specified by node['webpi']['home']. WebpiCmdLine.exe is used required by the webpi_product LWRP for taking all actions.

License & Authors

Author: Cookbook Engineering Team (cookbooks@chef.io)

Copyright: 2011-2016, Chef Software, Inc.

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.