Puppetlabs module for Apache

Apache is widely-used web server and this module will allow to configure various modules and setup virtual hosts with minimal effort.

Basic usage

To install Apache

class {'apache':  }

To install the Apache PHP module

class {'apache::mod::php': }

Configure a virtual host

You can easily configure many parameters of a virtual host. A minimal example is:

apache::vhost { 'www.example.com':
    priority        => '10',
    vhost_name      => '192.0.2.1',
    port            => '80',
}

A slightly more complicated example, which moves the docroot and logfile to an alternate location, might be:

apache::vhost { 'www.example.com':
    priority        => '10',
    vhost_name      => '192.0.2.1',
    port            => '80',
    docroot         => '/home/www.example.com/docroot/',
    logroot         => '/srv/www.example.com/logroot/',
    serveradmin     => 'webmaster@example.com',
    serveraliases   => ['example.com',],
}

Dependencies

Some functionality is dependent on other modules:

• stdlib
• firewall

Notes

Since Puppet cannot ensure that all parent directories exist you need to manage these yourself. In the more advanced example above, you need to ensure that /home/www.example.com and /srv/www.example.com directories exist.

Contributors

• A cast of hundreds, hopefully you too soon

Copyright and License

Copyright (C) 2012 Puppet Labs Inc

Puppet Labs can be contacted at: info@puppetlabs.com

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.

2013-03-2 Release 0.6.0

• update travis tests (add more supported versions)
• add access log_parameter
• make purging of vhost dir configurable

2012-08-24 Release 0.4.0 Changes:

• include apache is now required when using apache::mod::*

Bugfixes:

• Fix syntax for validate_re
• Fix formatting in vhost template
• Fix spec tests such that they pass

2012-05-08 Puppet Labs info@puppetlabs.com - 0.0.4 e62e362 Fix broken tests for ssl, vhost, vhost::* 42c6363 Changes to match style guide and pass puppet-lint without error 42bc8ba changed name => path for file resources in order to name namevar by it's name 72e13de One end too much 0739641 style guide fixes: 'true' <> true, $operatingsystem needs to be $::operatingsystem, etc. 273f94d fix tests a35ede5 (#13860) Make a2enmod/a2dismo commands optional 98d774e (#13860) Autorequire Package['httpd'] 05fcec5 (#13073) Add missing puppet spec tests 541afda (#6899) Remove virtual a2mod definition 976cb69 (#13072) Move mod python and wsgi package names to params 323915a (#13060) Add .gitignore to repo fdf40af (#13060) Remove pkg directory from source tree fd90015 Add LICENSE file and update the ModuleFile d3d0d23 Re-enable local php class d7516c7 Make management of firewalls configurable for vhosts 60f83ba Explicitly lookup scope of apache_name in templates. f4d287f (#12581) Add explicit ordering for vdir directory 88a2ac6 (#11706) puppetlabs-apache depends on puppetlabs-firewall a776a8b (#11071) Fix to work with latest firewall module 2b79e8b (#11070) Add support for Scientific Linux 405b3e9 Fix for a2mod 57b9048 Commit apache::vhost::redirect Manifest 8862d01 Commit apache::vhost::proxy Manifest d5c1fd0 Commit apache::mod::wsgi Manifest a825ac7 Commit apache::mod::python Manifest b77062f Commit Templates 9a51b4a Vhost File Declarations 6cf7312 Defaults for Parameters 6a5b11a Ensure installed f672e46 a2mod fix 8a56ee9 add pthon support to apache