apache
Version information
Start using this module
Add this module to your Puppetfile:
mod 'evenup-apache', '4.0.0'
Learn more about managing modules with a PuppetfileDocumentation
What is it?
A puppet module that installs apache with mod_evasive and mod_security (optional). This module has been written and tested on CentOS 6 and is primarily used for configuring apache as a proxy for Tomcat via AJP and other services via TCP, but it also has support for mod_passenger, mod_python, and mod_wsgi as well.
Disabling mod_security by vhost, rule, or IP are provided. JSON logging for vhosts allowing easy import into logstash is available.
Support for SSL certificates, password files, or any other sensitive information may be installed installed to a limted access directory through apache::securefile.
Monitoring by sensu is provided, but additional monitoring solutions can easily be added.
Usage:
Generic apache install
Adding a NameVirtualHost on port 80:
Generic config files:
Tomcat AJP proxy with http -> https redirect:
TCP proxy:
Static content:
Known Issues:
Only tested on CentOS 6
TODO:
[ ] Make mod_evasive optional [ ] Make mod_status optional and configurable [ ] Allow disabling mod_security by file [ ] Improve documentation, complex module
License:
Released under the Apache 2.0 licence
Contribute:
- Fork it
- Create a topic branch
- Improve/fix (with spec tests)
- Push new topic branch
- Submit a PR
20141111 - v4.0.0 Remove prepending 'Header' from header template 20141107 - v3.8.0 Add ability to set AllowOverride on docroot 20141010 - v3.7.0 Add ability to supply ErrorDocuments 20141002 - v3.6.0 Allow altering modsec restricted_extensiosn 20140918 - v3.5.0 Remove global auth params from proxies 20140605 - v3.4.0 Add logrotate to logstash json output files 20140603 - v3.3.0 Update JSON log output format for logstash version 1 20140219 - v3.2.2 HTTP -> HTTPS redirects are now 301 20140214 - v3.2.1 Fix for using both tomcatProxy and thinProxy 20140210 - v3.2.0 Add proxyThinUrl and proxyTomcatUrl parameter (backwards compatible) Move ProxyPass template to individual erb 20140205 - v3.1.0 Allow setting apache version Allow disabling mod_evasive Allow setting mod_evasive version 20140122 - v3.0.0 Mod_security now uses packaged rules Mod_security choose rule files per host Add support for text/x-component v2.3.0: Add ability to set custom Headers directives Update sensu checks v2.2.1: Add containment to module v2.2.0: Add custom logstash fields v2.1.0: Ensure apache version is latest Remove logrotate dependency Remove hiera dependency Add mod_deflate config Add mod_expires to vhost v2.0.0: Initial public release
Dependencies
- evenup/beaver (>= 1.1.0)
- puppetlabs/stdlib (>= 3.2.0)
- puppetlabs/concat (>= 0.2.0)
Copyright 2013 EvenUp 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.