https://github.com/voxpupuli/puppet-iis
Module to mange IIS with Puppet
https://github.com/voxpupuli/puppet-iis
hacktoberfest puppet windows-puppet-module
Last synced: 4 months ago
JSON representation
Module to mange IIS with Puppet
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-iis
- Owner: voxpupuli
- License: mit
- Created: 2013-06-04T13:08:41.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2021-08-29T11:55:28.000Z (about 4 years ago)
- Last Synced: 2025-06-27T04:05:58.168Z (4 months ago)
- Topics: hacktoberfest, puppet, windows-puppet-module
- Language: Ruby
- Homepage: https://forge.puppet.com/puppet/iis
- Size: 357 KB
- Stars: 46
- Watchers: 63
- Forks: 76
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Deprecation notice
This module has been moved to the care of Puppet, where it is now being maintained and updated. Find new versions at https://forge.puppet.com/puppetlabs/iis .
Details for migrating can be found at: https://github.com/puppetlabs/puppetlabs-iis/blob/master/MIGRATION.md
# IIS module for Puppet
[](https://travis-ci.org/voxpupuli/puppet-iis)
[](https://coveralls.io/github/voxpupuli/puppet-iis)
[](https://forge.puppetlabs.com/puppet/iis)
[](https://forge.puppetlabs.com/puppet/iis)
[](https://forge.puppetlabs.com/puppet/iis)
[](https://forge.puppetlabs.com/puppet/iis)
Module for puppet that can be used to create sites, application pools and
virtual applications with IIS 7 and above.
#### Table of Contents
1. [Overview](#overview)
1. [Requirements](#requirements)
1. [Types](#types)
* [iis_site](#iis_site)
* [iis_pool](#iis_pool)
* [iis_virtualdirectory](#iis_virtualdirectory)
* [iis_application](#iis_application)
## Overview
Create and manage IIS websites, application pools, and virtual applications.
## Requirements
- >= Windows 2012
- IIS installed
## Types
### iis_site
Enumerate all IIS websites:
* `puppet resource iis_site`
Example output for `puppet resource iis_site 'Default Web Site'`
```puppet
iis_site { 'Default Web Site':
ensure => 'started',
app_pool => 'DefaultAppPool',
ip => '*',
path => 'C:\InetPub\WWWRoot',
port => '80',
protocol => 'http',
ssl => 'false',
}
```
#### iis_site attributes
* `ensure` Denotes the presence and state of site. `{ present, absent, started,
stopped }` Default: `started`
* `name` (namevar) Web site's name.
* `path` Web root for the site. This can be left blank, although IIS won't
be able to start the site.
* `app_pool` The application pool which should contain the site. Default: `DefaultAppPool`
* `host_header` A host header that should apply to the site. Set to `false` to
maintain no host header.
* `protocol` The protocol for the site. Default `http`
* `ip` The IP address for the site to listen on. Default: `$::ipaddress`
* `port` The port for the site to listen on. Default: `80`
* `ssl` If SSL should be enabled. Default: `false`
* `state` Whether the site should be `Started` or `Stopped`. Default: `Started`
#### Refresh event
Sending a refresh event to an iis_site type will recycle the web site.
### iis_pool
Enumerate all IIS application pools:
* `puppet resource iis_pool`
Example output for `puppet resource iis_site 'DefaultAppPool'`
```puppet
iis_pool { 'DefaultAppPool':
ensure => 'started',
enable_32_bit => 'false',
pipeline => 'Integrated',
runtime => 'v4.0',
}
```
#### iis_pool attributes
* `ensure` Denotes the presence and state of pool. `{ present, absent, started,
stopped }` Default: `started`
* `name` (namevar) Application pool's name.
* `enable_32_bit` Enable 32-bit applications (boolean). Default: `false`
* `pipeline` The managed pipeline mode for the pool {'Classic', 'Integrated'}.
* `runtime` Version of .NET runtime for the pool (float).
* `state` Whether the site should be `Started` or `Stopped`. Default: `Started`
#### Refresh event
Sending a refresh event to an iis_pool type will recycle the application pool.
### iis_virtualdirectory
Enumerate all IIS virtual directories:
* `puppet resource iis_virtualdirectory`
Example output for `puppet resource iis_virtualdirectory 'default'`
```puppet
iis_virtualdirectory { 'default':
ensure => 'present',
path => 'C:\inetpub\wwwroot',
site => 'Default Web Site',
}
```
#### iis_virtualdirectory attributes
* `path` Target directory for the virtual directory.
* `site` (Read-only) Web site in which the virtual directory resides. To change
sites, remove and re-create virtual directory.
### iis_application
Enumerate all IIS applications:
* `puppet resource iis_application`
Example output for `puppet resource iis_site 'test_app'`
```puppet
iis_application { 'test_app':
ensure => 'present',
app_pool => 'DefaultAppPool',
path => 'C:\Temp',
site => 'Default Web Site',
}
```
#### iis_application attributes
* `app_pool` The application pool which should contain the application. Default:
`DefaultAppPool`
* `path` Root for the application. This can be left blank, although IIS won't
be able to use it.
* `site` (Read-only) Web site in which the application resides. To change sites,
remove and re-create application.