README.md

iis Cookbook

Description

Installs and configures Microsoft Internet Information Services (IIS) 7.0 and later

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

• Windows Server 2016
• Windows Server 2019

Chef

• Chef 12.14+

Cookbooks

• windows if running on chef < 16

Attributes

• node['iis']['home'] - IIS main home directory. default is %WINDIR%\System32\inetsrv
• node['iis']['conf_dir'] - location where main IIS configs lives. default is %WINDIR%\System32\inetsrv\config
• node['iis']['pubroot'] - . default is %SYSTEMDRIVE%\inetpub
• node['iis']['docroot'] - IIS web site home directory. default is %SYSTEMDRIVE%\inetpub\wwwroot
• node['iis']['cache_dir'] - location of cached data. default is %SYSTEMDRIVE%\inetpub\temp
• node['iis']['windows_feature_install_method'] - specify the install method that will be used by any windows_feature resources. If ommitted it will not be specified and will use windows_feature_dism by default. Valid options are :windows_feature_dism, :windows_feature_powershell, :windows_feature_servermanagercmd. Default is :windows_feature_dism

Resources

• iis_app
• iis_config_property
• iis_config
• iis_install
• iis_manager
• iis_manager_permission
• iis_module
• iis_pool
• iis_root
• iis_section
• iis_site
• iis_vdir

Recipies

These recipies still exist but are highly likely to be removed in future major releases of this cookbook.

default recipe

Installs and configures IIS 7.0/7.5/8.0 using the default configuration.

mod_* recipes

This cookbook also contains recipes for installing individual IIS modules (extensions). These recipes can be included in a node's run_list to build the minimal desired custom IIS installation.

• mod_aspnet - installs ASP.NET runtime components
• mod_aspnet45 - installs ASP.NET 4.5 runtime components
• mod_auth_basic - installs Basic Authentication support
• mod_auth_windows - installs Windows Authentication (authenticate clients by using NTLM or Kerberos) support
• mod_compress_dynamic - installs dynamic content compression support. PLEASE NOTE - enabling dynamic compression always gives you more efficient use of bandwidth, but if your server's processor utilization is already very high, the CPU load imposed by dynamic compression might make your site perform more slowly.
• mod_compress_static - installs static content compression support
• mod_ftp - installs FTP service
• mod_iis6_metabase_compat - installs IIS 6 Metabase Compatibility component.
• mod_isapi - installs ISAPI (Internet Server Application Programming Interface) extension and filter support.
• mod_logging - installs and enables HTTP Logging (logging of Web site activity), Logging Tools (logging tools and scripts) and Custom Logging (log any of the HTTP request/response headers, IIS server variables, and client-side fields with simple configuration) support
• mod_management - installs Web server Management Console which supports management of local and remote Web servers
• mod_security - installs URL Authorization (Authorizes client access to the URLs that comprise a Web application), Request Filtering (configures rules to block selected client requests) and IP Security (allows or denies content access based on IP address or domain name) support.
• mod_tracing - installs support for tracing ASP.NET applications and failed requests.

Note: Not every possible IIS module has a corresponding recipe. The foregoing recipes are included for convenience, but users may also place additional IIS modules that are installable as Windows features into the node['iis']['components'] array.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.