apache2 (126) Versions 8.9.1 Follow661

Installs and configures apache2

Policyfile

Berkshelf

Knife

cookbook 'apache2', '= 8.9.1', :supermarket

cookbook 'apache2', '= 8.9.1'

knife supermarket install apache2

knife supermarket download apache2

README

Dependencies

Changelog

Quality -%

apache2 Cookbook

This cookbook provides a complete Debian/Ubuntu style Apache HTTPD configuration. Non-Debian based distributions such as Red Hat/CentOS, ArchLinux and others supported by this cookbook will have a configuration that mimics Debian/Ubuntu style as it is easier to manage with Chef.

Debian-style Apache configuration uses scripts to manage modules and sites (vhosts). The scripts are:

a2ensite
a2dissite
a2enmod
a2dismod
a2enconf
a2disconf

This cookbook ships with templates of these scripts for non-Debian based platforms.

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.

Cookbooks

Depending on your OS configuration and security policy, you may need additional recipes or cookbooks for this cookbook's recipes to converge on the node. In particular, the following Operating System settings may affect the behavior of this cookbook:

SELinux enabled
Firewalls (such as iptables, ufw, etc.)
Compile tools
3rd party repositories

On RHEL, SELinux is enabled by default. The selinux cookbook contains a permissive recipe that can be used to set SELinux to "Permissive" state. Otherwise, additional recipes need to be created by the user to address SELinux permissions.

To deal with firewalls Chef Software does provide an iptables and ufw cookbook but is migrating from the approach used there to a more robust solution utilizing the general firewall cookbook to setup rules. See those cookbooks' READMEs for documentation.

On ArchLinux, if you are using the apache2::mod_auth_openid recipe, you also need the pacman cookbook for the pacman_aur LWRP. Put recipe[pacman] on the node's expanded run list (on the node or in a role). This is not an explicit dependency because it is only required for this single recipe and platform; the pacman default recipe performs pacman -Sy to keep pacman's package cache updated.

Platforms

The following platforms and versions are tested and supported using test-kitchen

Ubuntu 18.04 / 20.04
Debian 9/10
CentOS 7+
Fedora Latest
OpenSUSE Leap

Notes for RHEL Family

Apache2.4 support for Centos 6 is not officially supported.

Usage

It is recommended to create a project or organization specific wrapper cookbook and add the desired custom resources to the run list of a node. Depending on your environment, you may have multiple roles that use different recipes from this cookbook. Adjust any attributes as desired.

# service['apache2'] is defined in the apache2_default_install resource but other resources are currently unable to reference it.  To work around this issue, define the following helper in your cookbook:
service 'apache2' do
  service_name lazy { apache_platform_service_name }
  supports restart: true, status: true, reload: true
  action :nothing
end

apache2_install 'default_install'
apache2_module 'headers'
apache2_module 'ssl'

apache2_default_site 'foo' do
  default_site_name 'my_site'
  template_cookbook 'my_cookbook'
  port '443'
  template_source 'my_site.conf.erb'
  action :enable
end

Example wrapper cookbooks:
basic site
ssl site

Resources

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

apache2 Cookbook Changelog

This file is used to list changes made in each version of the apache2 cookbook.

8.9.1 - 2021-03-03

8.9.0 - 2021-01-27

Enable options property to pass arbitrary variables to the conf template

8.8.0 - 2021-01-26

Remove support and testing for Ubuntu 16.04

8.7.0 - 2020-11-20

Add template_cookbook property to install

8.6.0 (2020-10-13)

Add apache2_mod_wsgi resource
Fix backwards compatibility for SUSE with a2enmod

8.5.1 (2020-10-02)

Add apache namespace for site_available? and site_enabled? helper methods

8.5.0 (2020-09-22)

resolved cookstyle error: spec/libraries/default_modules_spec.rb:8:7 refactor: ChefCorrectness/IncorrectLibraryInjection
Cookstyle Bot Auto Corrections with Cookstyle 6.17.7
Directly include Apache2::Cookbook::Helpers in recipes and resources by default
config has now template_cookbook property to use an external template

8.4.0 (2020-09-09)

resolved cookstyle error: test/cookbooks/test/recipes/php.rb:1:1 refactor: ChefCorrectness/IncorrectLibraryInjection
Allow override of package name and version in install resource
Add tests for package name override

8.3.0 (2020-07-13)

Add mod_php resource

8.2.1 (2020-06-29)

Add missing lib_dir variable to a2enmod template

8.2.0 (2020-06-18)

Updated helpers to use platform_family? when possible to simplify code
Fixed incorrect platform version comparison logic in the helpers
Add new platforms to the Kitchen configs
Remove logic in the Linux helpers that checked for systemd vs. non-systemd since we only support systemd platforms now

8.1.2 - 2020-06-02

resolved cookstyle error: libraries/helpers.rb:196:14 refactor: ChefCorrectness/InvalidPlatformFamilyInCase
Enable unified_mode for all resources
- This deprecates support for Chef Infra Client 14 and below

[8.1.1] - 2020-04-12

Add CentOS 8 to CI pipeline
Add Debian 10 / Remove Debian 8 from CI pipeline
Rename libexec_dir to apache_libexec_dir

[8.1.0] - 2020-03-06

Add 'template_cookbook' property to apache2_module
Migrated to Github Actions for testing

Fixed

Cookstyle fixes

Removed

Removed circleci testing

[8.0.2] - 2019-11-15

default_apache_root_group: replace with ohai root_group

[8.0.1] - 2019-11-15

Fix not reloading service when changes in port.conf / apache2.conf

[8.0.0] - 2019-11-13

Fix cache_dir permission so that modules can write in their cache_dir/module/ storage space
Latest Cookstyle changes in cookstyle 5.6.2
Fixed bug with freebsd and suse modules adding an array to an array
Fixed mod_ssl for suse
Fixed docroot paths for suse

Breaking Changes

Renamed :cookbook property for apache2_default_site resource### Added

[7.1.1] - 2019-08-07

Allow overwriting cookbook for apache2_mod templates using template_cookbook property.

[7.1.0] - 29-05-2019

Add upgrading examples in UPGRADING.md
Remove references to recipes in README.md and add a simple example
Allow users to set / alter the default module list
Allow users to alter the default modules configuration without re### Added
Uniform way to pass IP's in mod_info and mod_status

[7.0.0] - 05-03-2019

Remove all recipes
Use declare_resource in apache2_module
Add default value to apache_2_mod_proxy
Fix spelling of default in access_file_name property in install.rb

[6.0.0] - 25-02-2019

See UPGRADING.md for upgrading.

v6 - Behaviour Changes

Default recipe now calls the install resource
Add helpers: for a full list see libraries/helpers.rb
Remove all mpm_ recipes. Move mpm setup to the install resource
Allow user to set the mpm mode no matter what platform they're on
Remove FreeBSD, openSuse & Fedora Kitchen testing
mod_ recipes now call apache2_module_
Mod templates are now more configurable when calling the resources directly
Add apache2_default_site resource
Remove and document apache2_webapp resource
Add the default_site resource for managing the default site
Add site resource
Remove the web_app resource as it was very perscriptive
Add mod_ssl

v6 - Testing/CI

Add CircleCI and remove Travis
Add CircleCI Orbs
Rename test cookbook name to test
Cleanup test integration directory
Specs added for most helpers
Make sysconfig parameters configurable via the install resource

v6 - Misc Updates & Improvements

Update README with new instructions on installing
Set the server to listen on ports 80 and 443 by default
Fix Options allowed in alias.conf
Add resource documentation to documentation directory

[5.2.1] - 04-09-2018

Revert ports.conf fix (ports.conf that gets installed by package conflicts.

[5.2.0] - 26-08-2018

Drop Chef 12 support
Add Danger and CircleCI support
Move apache binary detection to the helpers file
Adds apache_platform_service_name, apache_dir ,apache_conf_dir helpers
Update kitchen configuration
Fix ports.conf location and how its set up (#550, skadz)
Allow httpd -t timeout to be configurable (#547, skadz)

[5.0.1] - 2017-09-01

Test using dokken-images in kitchen-dokken
Fix readme section for mod_php
Replace the existing testing.md contents with a link to the Chef testing docs
Fix mod_ldap failing on non-RHEL platforms
Fix mod_dav_svn to install the correct packages on Debian 8/9

[5.0.0] - 2017-07-13

Breaking changes

Support for Apache 2.2 has been fully removed so we can focus on providing a solid experience for Apache 2.4 and above. This removes support for RHEL 6, SLES 11, and Debian 7

Other changes

Fixed openSUSE support in multiple places and added integration testing for openSUSE in Travis

[4.0.0] - 2017-07-10

This cookbook now requires Chef 12.1 or later
Support for Apache 2.2 on FreeBSD has been removed
Support for Amazon Linux < 2013.09 has been removed
Support for end of life releases of Fedora (< 24), CentOS (5), Debian (6), Linux Mint (17), and Ubuntu (12.04) have been removed
Removed the deprecated recipes for mod_authz_default and mod_php5
Switched many package resources to Chef 12+ multipackage style to speed up Chef converges and reduce log clutter
mod_cache is now enabled when using mod_cache_disk and mod_cache_socache
The mod_cloudflare recipe now sets up the Apt repo with https
Improved support for Amazon Linux on Chef 13 and added Test Kitchen amazon testing
Improved support for Debian and RHEL derivative platforms
Improved Fedora support in multiple modules
Improved error logging for unsupported platforms in the mod_negotiation and mod_unixd recipes
Switched from Rake for testing to Delivery local mode
Setup integration testing with kitchen-dokken for core platforms in Travis so that every PR is now fully tested
Removed the EC2 and Docker kitchen files now that we have kitchen-dokken setup
Removed apt, pacman, yum, and zypper from the Berksfile as they're no longer needed for testing
Removed testing dependencies from the Gemfile as we're testing using ChefDK
Added integration testing for new Debian releases

Pre 4.0 Changelog

For changelog entries pre4.0 please see [the pre-4.0 CHANGELOG](CHANGELOG-pre4.md).

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status