other/Puppet: modules/apache/README.md annotate

annotate modules/apache/README.md @ 448:460bf6514bd8

Remove WarFoundry config

author	IBBoard <dev@ibboard.co.uk>
date	Sat, 15 Jul 2023 13:31:32 +0100
parents	b8d6ada284dd
children	adf6fe9bbc17

rev	line source
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	1 # apache
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	2
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	3 [Module description]: #module-description
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	4
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	5 [Setup]: #setup
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	6 [Beginning with Apache]: #beginning-with-apache
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	7
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	8 [Usage]: #usage
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	9 [Configuring virtual hosts]: #configuring-virtual-hosts
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	10 [Configuring virtual hosts with SSL]: #configuring-virtual-hosts-with-ssl
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	11 [Configuring virtual host port and address bindings]: #configuring-virtual-host-port-and-address-bindings
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	12 [Configuring virtual hosts for apps and processors]: #configuring-virtual-hosts-for-apps-and-processors
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	13 [Configuring IP-based virtual hosts]: #configuring-ip-based-virtual-hosts
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	14 [Installing Apache modules]: #installing-apache-modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	15 [Installing arbitrary modules]: #installing-arbitrary-modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	16 [Installing specific modules]: #installing-specific-modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	17 [Load balancing examples]: #load-balancing-examples
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	18 [apache affects]: #what-the-apache-module-affects
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	19
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	20 [Reference]: #reference
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	21
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	22 [Limitations]: #limitations
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	23
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	24 [Development]: #development
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	25
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	26 [`AddDefaultCharset`]: https://httpd.apache.org/docs/current/mod/core.html#adddefaultcharset
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	27 [`add_listen`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#add_listen
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	28 [`Alias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#alias
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	29 [`AliasMatch`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#aliasmatch
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	30 [aliased servers]: https://httpd.apache.org/docs/current/urlmapping.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	31 [`AllowEncodedSlashes`]: https://httpd.apache.org/docs/current/mod/core.html#allowencodedslashes
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	32 [`apache`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apache
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	33 [`apache_version`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apache_version
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	34 [`apache::balancer`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachebalancer
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	35 [`apache::balancermember`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachebalancermember
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	36 [`apache::mod`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemod
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	37 [`apache::mod::<MODULE NAME>`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#public-classes
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	38 [`apache::mod::alias`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodalias
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	39 [`apache::mod::auth_cas`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodauth_cas
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	40 [`apache::mod::auth_mellon`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodauth_mellon
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	41 [`apache::mod::authn_dbd`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodauthn_dbd
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	42 [`apache::mod::authnz_ldap`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodauthnz_ldap
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	43 [`apache::mod::cluster`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodcluster
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	44 [`apache::mod::data]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemoddata
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	45 [`apache::mod::disk_cache`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemoddisk_cache
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	46 [`apache::mod::dumpio`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemoddumpio
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	47 [`apache::mod::event`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodevent
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	48 [`apache::mod::ext_filter`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodext_filter
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	49 [`apache::mod::geoip`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodgeoip
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	50 [`apache::mod::http2`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodhttp2
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	51 [`apache::mod::itk`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemoditk
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	52 [`apache::mod::jk`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodjk
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	53 [`apache::mod::ldap`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodldap
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	54 [`apache::mod::passenger`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodpassenger
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	55 [`apache::mod::peruser`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodperuser
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	56 [`apache::mod::prefork`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodprefork
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	57 [`apache::mod::proxy`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodproxy
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	58 [`apache::mod::proxy_balancer`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodproxybalancer
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	59 [`apache::mod::proxy_fcgi`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodproxy_fcgi
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	60 [`apache::mod::proxy_html`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodproxy_html
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	61 [`apache::mod::python`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodpython
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	62 [`apache::mod::security`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodsecurity
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	63 [`apache::mod::shib`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodshib
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	64 [`apache::mod::ssl`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodssl
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	65 [`apache::mod::status`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodstatus
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	66 [`apache::mod::userdir`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemoduserdir
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	67 [`apache::mod::worker`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodworker
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	68 [`apache::mod::wsgi`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachemodwsgi
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	69 [`apache::params`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#private-classes
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	70 [`apache::version`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#private-classes
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	71 [`apache::vhost`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachevhost
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	72 [`apache::vhost::custom`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachevhostcustom
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	73 [Apache HTTP Server]: https://httpd.apache.org
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	74 [Apache modules]: https://httpd.apache.org/docs/current/mod/
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	75 [array]: https://docs.puppet.com/puppet/latest/lang_data_array.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	76
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	77 [audit log]: https://github.com/SpiderLabs/ModSecurity/wiki/ModSecurity-2-Data-Formats#audit-log
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	78
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	79 [beaker-rspec]: https://github.com/puppetlabs/beaker-rspec
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	80
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	81 [certificate revocation list]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationfile
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	82 [certificate revocation list path]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationpath
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	83 [common gateway interface]: https://httpd.apache.org/docs/current/howto/cgi.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	84 [`conf_dir`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#conf_dir
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	85 [custom error documents]: https://httpd.apache.org/docs/current/custom-error.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	86 [`custom_fragment`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#custom_fragment
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	87
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	88 [`default_mods`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#default_mods
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	89 [`default_ssl_crl`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#default_ssl_crl
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	90 [`default_ssl_crl_path`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#default_ssl_crl_path
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	91 [`default_ssl_vhost`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#default_ssl_vhost
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	92 [`dev_packages`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#dev_packages
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	93 [`directories`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#directories
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	94 [`DirectoryIndex`]: https://httpd.apache.org/docs/current/mod/mod_dir.html#directoryindex
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	95 [`docroot`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#docroot
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	96 [`docroot_owner`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#docroot_owner
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	97 [`docroot_group`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#docroot_group
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	98 [`DocumentRoot`]: https://httpd.apache.org/docs/current/mod/core.html#documentroot
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	99
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	100 [`EnableSendfile`]: https://httpd.apache.org/docs/current/mod/core.html#enablesendfile
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	101 [enforcing mode]: http://selinuxproject.org/page/Guide/Mode
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	102 [`ensure`]: https://docs.puppet.com/latest/type.html#package-attribute-ensure
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	103 [`error_log_file`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#error_log_file
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	104 [`error_log_syslog`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#error_log_syslog
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	105 [`error_log_pipe`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#error_log_pipe
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	106 [`ExpiresByType`]: https://httpd.apache.org/docs/current/mod/mod_expires.html#expiresbytype
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	107 [exported resources]: https://puppet.com/docs/puppet/latest/lang_exported.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	108 [`ExtendedStatus`]: https://httpd.apache.org/docs/current/mod/core.html#extendedstatus
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	109
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	110 [Facter]: http://docs.puppet.com/facter/
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	111 [FallbackResource]: https://httpd.apache.org/docs/current/mod/mod_dir.html#fallbackresource
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	112 [`fallbackresource`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#fallbackresource
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	113 [`FileETag`]: https://httpd.apache.org/docs/current/mod/core.html#fileetag
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	114 [filter rules]: https://httpd.apache.org/docs/current/filter.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	115 [`filters`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#filters
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	116 [`ForceType`]: https://httpd.apache.org/docs/current/mod/core.html#forcetype
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	117
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	118 [GeoIPScanProxyHeaders]: http://dev.maxmind.com/geoip/legacy/mod_geoip2/#Proxy-Related_Directives
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	119 [`gentoo/puppet-portage`]: https://github.com/gentoo/puppet-portage
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	120
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	121 [Hash]: https://docs.puppet.com/puppet/latest/lang_data_hash.html
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	122 [`HttpProtocolOptions`]: http://httpd.apache.org/docs/current/mod/core.html#httpprotocoloptions
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	123
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	124 [IAC Team]: https://puppetlabs.github.io/iac/
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	125 [`IncludeOptional`]: https://httpd.apache.org/docs/current/mod/core.html#includeoptional
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	126 [`Include`]: https://httpd.apache.org/docs/current/mod/core.html#include
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	127 [interval syntax]: https://httpd.apache.org/docs/current/mod/mod_expires.html#AltSyn
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	128 [`ip`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ip
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	129 [`ip_based`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ip_based
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	130 [IP-based virtual hosts]: https://httpd.apache.org/docs/current/vhosts/ip-based.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	131
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	132 [`limitreqfieldsize`]: https://httpd.apache.org/docs/current/mod/core.html#limitrequestfieldsize
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	133 [`limitreqfields`]: http://httpd.apache.org/docs/current/mod/core.html#limitrequestfields
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	134
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	135 [`lib`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#lib
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	136 [`lib_path`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#lib_path
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	137 [`Listen`]: https://httpd.apache.org/docs/current/bind.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	138 [`ListenBackLog`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#listenbacklog
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	139 [`LoadFile`]: https://httpd.apache.org/docs/current/mod/mod_so.html#loadfile
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	140 [`LogFormat`]: https://httpd.apache.org/docs/current/mod/mod_log_config.html#logformat
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	141 [`logroot`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#logroot
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	142 [Log security]: https://httpd.apache.org/docs/current/logs.html#security
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	143
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	144 [`manage_docroot`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#manage_docroot
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	145 [`manage_user`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#manage_user
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	146 [`manage_group`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#manage_group
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	147 [`supplementary_groups`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#supplementary_groups
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	148 [`MaxConnectionsPerChild`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxconnectionsperchild
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	149 [`max_keepalive_requests`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#max_keepalive_requests
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	150 [`MaxRequestWorkers`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxrequestworkers
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	151 [`MaxSpareThreads`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxsparethreads
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	152 [MIME `content-type`]: https://www.iana.org/assignments/media-types/media-types.xhtml
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	153 [`MinSpareThreads`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#minsparethreads
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	154 [`mod_alias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	155 [`mod_auth_cas`]: https://github.com/Jasig/mod_auth_cas
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	156 [`mod_auth_kerb`]: http://modauthkerb.sourceforge.net/configure.html
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	157 [`mod_auth_gssapi`]: https://github.com/modauthgssapi/mod_auth_gssapi
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	158 [`mod_authnz_external`]: https://github.com/phokz/mod-auth-external
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	159 [`mod_auth_dbd`]: http://httpd.apache.org/docs/current/mod/mod_authn_dbd.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	160 [`mod_auth_mellon`]: https://github.com/UNINETT/mod_auth_mellon
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	161 [`mod_dbd`]: http://httpd.apache.org/docs/current/mod/mod_dbd.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	162 [`mod_disk_cache`]: https://httpd.apache.org/docs/2.2/mod/mod_disk_cache.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	163 [`mod_dumpio`]: https://httpd.apache.org/docs/2.4/mod/mod_dumpio.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	164 [`mod_env`]: http://httpd.apache.org/docs/current/mod/mod_env.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	165 [`mod_expires`]: https://httpd.apache.org/docs/current/mod/mod_expires.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	166 [`mod_ext_filter`]: https://httpd.apache.org/docs/current/mod/mod_ext_filter.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	167 [`mod_fcgid`]: https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	168 [`mod_geoip`]: http://dev.maxmind.com/geoip/legacy/mod_geoip2/
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	169 [`mod_http2`]: https://httpd.apache.org/docs/current/mod/mod_http2.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	170 [`mod_info`]: https://httpd.apache.org/docs/current/mod/mod_info.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	171 [`mod_ldap`]: https://httpd.apache.org/docs/2.2/mod/mod_ldap.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	172 [`mod_mpm_event`]: https://httpd.apache.org/docs/current/mod/event.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	173 [`mod_negotiation`]: https://httpd.apache.org/docs/current/mod/mod_negotiation.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	174 [`mod_pagespeed`]: https://developers.google.com/speed/pagespeed/module/?hl=en
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	175 [`mod_passenger`]: https://www.phusionpassenger.com/library/config/apache/reference/
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	176 [`mod_php`]: http://php.net/manual/en/book.apache.php
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	177 [`mod_proxy`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	178 [`mod_proxy_balancer`]: https://httpd.apache.org/docs/current/mod/mod_proxy_balancer.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	179 [`mod_reqtimeout`]: https://httpd.apache.org/docs/current/mod/mod_reqtimeout.html
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	180 [`mod_python`]: http://modpython.org/
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	181 [`mod_rewrite`]: https://httpd.apache.org/docs/current/mod/mod_rewrite.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	182 [`mod_security`]: https://www.modsecurity.org/
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	183 [`mod_ssl`]: https://httpd.apache.org/docs/current/mod/mod_ssl.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	184 [`mod_status`]: https://httpd.apache.org/docs/current/mod/mod_status.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	185 [`mod_version`]: https://httpd.apache.org/docs/current/mod/mod_version.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	186 [`mod_wsgi`]: https://modwsgi.readthedocs.org/en/latest/
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	187 [module contribution guide]: https://docs.puppet.com/forge/contributing.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	188 [`mpm_module`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#mpm_module
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	189 [multi-processing module]: https://httpd.apache.org/docs/current/mpm.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	190
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	191 [name-based virtual hosts]: https://httpd.apache.org/docs/current/vhosts/name-based.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	192 [`no_proxy_uris`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#no_proxy_uris
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	193
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	194 [open source Puppet]: https://docs.puppet.com/puppet/
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	195 [`Options`]: https://httpd.apache.org/docs/current/mod/core.html#options
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	196
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	197 [`path`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#path
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	198 [`Peruser`]: https://www.freebsd.org/cgi/url.cgi?ports/www/apache22-peruser-mpm/pkg-descr
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	199 [`port`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#port-3
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	200 [`priority`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#priority
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	201 [`proxy_dest`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#proxy_dest
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	202 [`proxy_dest_match`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#proxy_dest_match
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	203 [`proxy_pass`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#proxy_pass
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	204 [`ProxyPass`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypass
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	205 [`proxy_set`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyset
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	206 [Puppet Enterprise]: https://docs.puppet.com/pe/
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	207 [Puppet Forge]: https://forge.puppet.com
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	208 [Puppet]: https://puppet.com
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	209 [Puppet module]: https://docs.puppet.com/puppet/latest/modules_fundamentals.html
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	210 [Puppet module's code]: https://github.com/puppetlabs/puppetlabs-apache/blob/main/manifests/default_mods.pp
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	211 [`purge_configs`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#purge_configs
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	212 [`purge_vhost_dir`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#purge_vhost_dir
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	213 [Python]: https://www.python.org/
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	214
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	215 [Rack]: http://rack.github.io/
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	216 [`rack_base_uri`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#rack_base_uri
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	217 [RFC 2616]: https://www.ietf.org/rfc/rfc2616.txt
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	218 [`RequestReadTimeout`]: https://httpd.apache.org/docs/current/mod/mod_reqtimeout.html#requestreadtimeout
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	219 [rspec-puppet]: http://rspec-puppet.com/
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	220
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	221 [`ScriptAlias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#scriptalias
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	222 [`ScriptAliasMatch`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#scriptaliasmatch
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	223 [`scriptalias`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#scriptalias
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	224 [SELinux]: http://selinuxproject.org/
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	225 [`ServerAdmin`]: https://httpd.apache.org/docs/current/mod/core.html#serveradmin
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	226 [`serveraliases`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#serveraliases
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	227 [`ServerLimit`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#serverlimit
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	228 [`ServerName`]: https://httpd.apache.org/docs/current/mod/core.html#servername
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	229 [`ServerRoot`]: https://httpd.apache.org/docs/current/mod/core.html#serverroot
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	230 [`ServerTokens`]: https://httpd.apache.org/docs/current/mod/core.html#servertokens
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	231 [`ServerSignature`]: https://httpd.apache.org/docs/current/mod/core.html#serversignature
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	232 [Service attribute restart]: http://docs.puppet.com/latest/type.html#service-attribute-restart
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	233 [`SSLCARevocationCheck`]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationcheck
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	234 [SSL certificate key file]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcertificatekeyfile
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	235 [SSL chain]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcertificatechainfile
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	236 [SSL encryption]: https://httpd.apache.org/docs/current/ssl/index.html
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	237 [`ssl`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ssl
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	238 [`ssl_cert`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ssl_cert
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	239 [`ssl_compression`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ssl_compression
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	240 [`ssl_key`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#ssl_key
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	241 [`StartServers`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#startservers
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	242 [supported operating system]: https://forge.puppet.com/supported#puppet-supported-modules-compatibility-matrix
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	243
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	244 [`ThreadLimit`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#threadlimit
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	245 [`ThreadsPerChild`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#threadsperchild
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	246 [`TimeOut`]: https://httpd.apache.org/docs/current/mod/core.html#timeout
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	247 [template]: http://docs.puppet.com/puppet/latest/reference/lang_template.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	248 [`TraceEnable`]: https://httpd.apache.org/docs/current/mod/core.html#traceenable
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	249
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	250 [`UseCanonicalName`]: https://httpd.apache.org/docs/current/mod/core.html#usecanonicalname
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	251
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	252 [`verify_config`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#verify_config
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	253 [`vhost`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#apachevhost
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	254 [`vhost_dir`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#vhost_dir
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	255 [`virtual_docroot`]: https://forge.puppet.com/modules/puppetlabs/apache/reference#virtual_docroot
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	256
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	257 [Web Server Gateway Interface]: https://www.python.org/dev/peps/pep-3333/#abstract
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	258 [`WSGIRestrictEmbedded`]: http://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIRestrictEmbedded.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	259 [`WSGIPythonPath`]: http://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIPythonPath.html
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	260 [`WSGIPythonHome`]: http://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIPythonHome.html
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	261 [`WSGIApplicationGroup`]: https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIApplicationGroup.html
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	262 [`WSGIPythonOptimize`]: https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIPythonOptimize.html
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	263
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	264 #### Table of Contents
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	265
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	266 1. [Module description - What is the apache module, and what does it do?][Module description]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	267 2. [Setup - The basics of getting started with apache][Setup]
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	268 - [What the apache module affects][apache affects]
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	269 - [Beginning with Apache - Installation][Beginning with Apache]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	270 3. [Usage - The classes and defined types available for configuration][Usage]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	271 - [Configuring virtual hosts - Examples to help get started][Configuring virtual hosts]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	272 - [Load balancing with exported and non-exported resources][Load balancing examples]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	273 4. [Reference - An under-the-hood peek at what the module is doing and how][Reference]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	274 5. [Limitations - OS compatibility, etc.][Limitations]
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	275 6. [Development - Guide for contributing to the module][Development]
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	276
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	277 <a id="module-description"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	278 ## Module description
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	279
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	280 [Apache HTTP Server][] (also called Apache HTTPD, or simply Apache) is a widely used web server. This [Puppet module][] simplifies the task of creating configurations to manage Apache servers in your infrastructure. It can configure and manage a range of virtual host setups and provides a streamlined way to install and configure [Apache modules][].
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	281
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	282 <a id="setup"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	283 ## Setup
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	284
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	285 <a id="apache-affects"></a>
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	286 ### What the apache module affects:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	287
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	288 - Configuration files and directories (created and written to)
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	289 - WARNING: Configurations not managed by Puppet will be purged.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	290 - Package/service/configuration files for Apache
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	291 - Apache modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	292 - Virtual hosts
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	293 - Listened-to ports
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	294 - `/etc/make.conf` on FreeBSD and Gentoo
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	295
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	296 On Gentoo, this module depends on the [`gentoo/puppet-portage`][] Puppet module. Note that while several options apply or enable certain features and settings for Gentoo, it is not a [supported operating system][] for this module.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	297
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	298 > Warning: This module modifies Apache configuration files and directories and purges any configuration not managed by Puppet. Apache configuration should be managed by Puppet, as unmanaged configuration files can cause unexpected failures.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	299 >
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	300 >To temporarily disable full Puppet management, set the [`purge_configs`][] parameter in the [`apache`][] class declaration to false. We recommend this only as a temporary means of saving and relocating customized configurations.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	301
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	302 <a id="beginning-with-apache"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	303 ### Beginning with Apache
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	304
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	305 To have Puppet install Apache with the default parameters, declare the [`apache`][] class:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	306
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	307 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	308 class { 'apache': }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	309 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	310
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	311 When you declare this class with the default options, the module:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	312
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	313 - Installs the appropriate Apache software package and [required Apache modules][`default_mods`] for your operating system.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	314 - Places the required configuration files in a directory, with the [default location][`conf_dir`] Depends on operating system.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	315 - Configures the server with a default virtual host and standard port (80) and address ('\*') bindings.
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	316 - Creates a document root directory Depends on operating system, typically `/var/www`.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	317 - Starts the Apache service.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	318
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	319 Apache defaults depend on your operating system. These defaults work in testing environments but are not suggested for production. We recommend customizing the class's parameters to suit your site.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	320
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	321 For instance, this declaration installs Apache without the apache module's [default virtual host configuration][Configuring virtual hosts], allowing you to customize all Apache virtual hosts:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	322
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	323 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	324 class { 'apache':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	325 default_vhost => false,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	326 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	327 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	328
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	329 > Note: When `default_vhost` is set to `false`, you have to add at least one `apache::vhost` resource or Apache will not start. To establish a default virtual host, either set the `default_vhost` in the `apache` class or use the [`apache::vhost`][] defined type. You can also configure additional specific virtual hosts with the [`apache::vhost`][] defined type.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	330
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	331 <a id="usage"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	332 ## Usage
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	333
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	334 <a id="configuring-virtual-hosts"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	335 ### Configuring virtual hosts
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	336
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	337 The default [`apache`][] class sets up a virtual host on port 80, listening on all interfaces and serving the [`docroot`][] parameter's default directory of `/var/www`.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	338
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	339
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	340 To configure basic [name-based virtual hosts][], specify the [`port`][] and [`docroot`][] parameters in the [`apache::vhost`][] defined type:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	341
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	342 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	343 apache::vhost { 'vhost.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	344 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	345 docroot => '/var/www/vhost',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	346 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	347 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	348
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	349 See the [`apache::vhost`][] defined type's reference for a list of all virtual host parameters.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	350
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	351 > Note: Apache processes virtual hosts in alphabetical order, and server administrators can prioritize Apache's virtual host processing by prefixing a virtual host's configuration file name with a number. The [`apache::vhost`][] defined type applies a default [`priority`][] of 25, which Puppet interprets by prefixing the virtual host's file name with `25-`. This means that if multiple sites have the same priority, or if you disable priority numbers by setting the `priority` parameter's value to false, Apache still processes virtual hosts in alphabetical order.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	352
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	353 To configure user and group ownership for `docroot`, use the [`docroot_owner`][] and [`docroot_group`][] parameters:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	354
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	355 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	356 apache::vhost { 'user.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	357 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	358 docroot => '/var/www/user',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	359 docroot_owner => 'www-data',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	360 docroot_group => 'www-data',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	361 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	362 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	363
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	364 #### Configuring virtual hosts with SSL
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	365
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	366 To configure a virtual host to use [SSL encryption][] and default SSL certificates, set the [`ssl`][] parameter. You must also specify the [`port`][] parameter, typically with a value of 443, to accommodate HTTPS requests:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	367
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	368 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	369 apache::vhost { 'ssl.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	370 port => 443,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	371 docroot => '/var/www/ssl',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	372 ssl => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	373 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	374 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	375
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	376 To configure a virtual host to use SSL and specific SSL certificates, use the paths to the certificate and key in the [`ssl_cert`][] and [`ssl_key`][] parameters, respectively:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	377
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	378 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	379 apache::vhost { 'cert.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	380 port => 443,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	381 docroot => '/var/www/cert',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	382 ssl => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	383 ssl_cert => '/etc/ssl/fourth.example.com.cert',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	384 ssl_key => '/etc/ssl/fourth.example.com.key',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	385 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	386 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	387
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	388 To configure a mix of SSL and unencrypted virtual hosts at the same domain, declare them with separate [`apache::vhost`][] defined types:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	389
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	390 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	391 # The non-ssl virtual host
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	392 apache::vhost { 'mix.example.com non-ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	393 servername => 'mix.example.com',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	394 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	395 docroot => '/var/www/mix',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	396 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	397
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	398 # The SSL virtual host at the same domain
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	399 apache::vhost { 'mix.example.com ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	400 servername => 'mix.example.com',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	401 port => 443,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	402 docroot => '/var/www/mix',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	403 ssl => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	404 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	405 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	406
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	407 To configure a virtual host to redirect unencrypted connections to SSL, declare them with separate [`apache::vhost`][] defined types and redirect unencrypted requests to the virtual host with SSL enabled:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	408
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	409 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	410 apache::vhost { 'redirect.example.com non-ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	411 servername => 'redirect.example.com',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	412 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	413 docroot => '/var/www/redirect',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	414 redirect_status => 'permanent',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	415 redirect_dest => 'https://redirect.example.com/'
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	416 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	417
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	418 apache::vhost { 'redirect.example.com ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	419 servername => 'redirect.example.com',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	420 port => 443,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	421 docroot => '/var/www/redirect',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	422 ssl => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	423 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	424 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	425
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	426 #### Configuring virtual host port and address bindings
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	427
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	428 Virtual hosts listen on all IP addresses ('\*') by default. To configure the virtual host to listen on a specific IP address, use the [`ip`][] parameter:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	429
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	430 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	431 apache::vhost { 'ip.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	432 ip => '127.0.0.1',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	433 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	434 docroot => '/var/www/ip',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	435 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	436 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	437
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	438 You can also configure more than one IP address per virtual host by using an array of IP addresses for the [`ip`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	439
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	440 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	441 apache::vhost { 'ip.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	442 ip => ['127.0.0.1','169.254.1.1'],
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	443 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	444 docroot => '/var/www/ip',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	445 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	446 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	447
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	448 You can configure multiple ports per virtual host by using an array of ports for the [`port`][] parameter:
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	449
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	450 ``` puppet
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	451 apache::vhost { 'ip.example.com':
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	452 ip => ['127.0.0.1'],
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	453 port => [80, 8080]
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	454 docroot => '/var/www/ip',
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	455 }
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	456 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	457
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	458 To configure a virtual host with [aliased servers][], refer to the aliases using the [`serveraliases`][] parameter:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	459
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	460 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	461 apache::vhost { 'aliases.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	462 serveraliases => [
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	463 'aliases.example.org',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	464 'aliases.example.net',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	465 ],
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	466 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	467 docroot => '/var/www/aliases',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	468 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	469 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	470
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	471 To set up a virtual host with a wildcard alias for the subdomain mapped to a directory of the same name, such as 'http://example.com.loc' mapped to `/var/www/example.com`, define the wildcard alias using the [`serveraliases`][] parameter and the document root with the [`virtual_docroot`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	472
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	473 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	474 apache::vhost { 'subdomain.loc':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	475 vhost_name => '*',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	476 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	477 virtual_docroot => '/var/www/%-2+',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	478 docroot => '/var/www',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	479 serveraliases => ['*.loc',],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	480 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	481 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	482
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	483 To configure a virtual host with [filter rules][], pass the filter directives as an [array][] using the [`filters`][] parameter:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	484
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	485 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	486 apache::vhost { 'subdomain.loc':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	487 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	488 filters => [
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	489 'FilterDeclare COMPRESS',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	490 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/html',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	491 'FilterChain COMPRESS',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	492 'FilterProtocol COMPRESS DEFLATE change=yes;byteranges=no',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	493 ],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	494 docroot => '/var/www/html',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	495 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	496 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	497
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	498 #### Configuring virtual hosts for apps and processors
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	499
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	500 To configure a virtual host to use the [Web Server Gateway Interface][] (WSGI) for [Python][] applications, use the `wsgi` set of parameters:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	501
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	502 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	503 apache::vhost { 'wsgi.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	504 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	505 docroot => '/var/www/pythonapp',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	506 wsgi_application_group => '%{GLOBAL}',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	507 wsgi_daemon_process => 'wsgi',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	508 wsgi_daemon_process_options => {
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	509 processes => 2,
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	510 threads => 15,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	511 display-name => '%{GROUP}',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	512 },
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	513 wsgi_import_script => '/var/www/demo.wsgi',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	514 wsgi_import_script_options => {
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	515 process-group => 'wsgi',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	516 application-group => '%{GLOBAL}',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	517 },
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	518 wsgi_process_group => 'wsgi',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	519 wsgi_script_aliases => { '/' => '/var/www/demo.wsgi' },
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	520 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	521 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	522
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	523 As of Apache 2.2.16, Apache supports [FallbackResource][], a simple replacement for common RewriteRules. You can set a FallbackResource using the [`fallbackresource`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	524
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	525 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	526 apache::vhost { 'wordpress.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	527 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	528 docroot => '/var/www/wordpress',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	529 fallbackresource => '/index.php',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	530 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	531 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	532
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	533 > Note: The `fallbackresource` parameter only supports the 'disabled' value since Apache 2.2.24.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	534
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	535 To configure a virtual host with a designated directory for [Common Gateway Interface][] (CGI) files, use the [`scriptalias`][] parameter to define the `cgi-bin` path:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	536
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	537 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	538 apache::vhost { 'cgi.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	539 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	540 docroot => '/var/www/cgi',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	541 scriptalias => '/usr/lib/cgi-bin',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	542 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	543 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	544
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	545 To configure a virtual host for [Rack][], use the [`rack_base_uri`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	546
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	547 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	548 apache::vhost { 'rack.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	549 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	550 docroot => '/var/www/rack',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	551 rack_base_uri => ['/rackapp1', '/rackapp2'],
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	552 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	553 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	554
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	555 #### Configuring IP-based virtual hosts
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	556
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	557 You can configure [IP-based virtual hosts][] to listen on any port and have them respond to requests on specific IP addresses. In this example, the server listens on ports 80 and 81, because the example virtual hosts are _not_ declared with a [`port`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	558
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	559 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	560 apache::listen { '80': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	561
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	562 apache::listen { '81': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	563 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	564
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	565 Configure the IP-based virtual hosts with the [`ip_based`][] parameter:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	566
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	567 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	568 apache::vhost { 'first.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	569 ip => '10.0.0.10',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	570 docroot => '/var/www/first',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	571 ip_based => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	572 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	573
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	574 apache::vhost { 'second.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	575 ip => '10.0.0.11',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	576 docroot => '/var/www/second',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	577 ip_based => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	578 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	579 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	580
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	581 You can also configure a mix of IP- and [name-based virtual hosts][] in any combination of [SSL][SSL encryption] and unencrypted configurations.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	582
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	583 In this example, we add two IP-based virtual hosts on an IP address (in this example, 10.0.0.10). One uses SSL and the other is unencrypted:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	584
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	585 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	586 apache::vhost { 'The first IP-based virtual host, non-ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	587 servername => 'first.example.com',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	588 ip => '10.0.0.10',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	589 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	590 ip_based => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	591 docroot => '/var/www/first',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	592 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	593
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	594 apache::vhost { 'The first IP-based vhost, ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	595 servername => 'first.example.com',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	596 ip => '10.0.0.10',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	597 port => 443,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	598 ip_based => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	599 docroot => '/var/www/first-ssl',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	600 ssl => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	601 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	602 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	603
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	604 Next, we add two name-based virtual hosts listening on a second IP address (10.0.0.20):
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	605
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	606 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	607 apache::vhost { 'second.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	608 ip => '10.0.0.20',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	609 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	610 docroot => '/var/www/second',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	611 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	612
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	613 apache::vhost { 'third.example.com':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	614 ip => '10.0.0.20',
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	615 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	616 docroot => '/var/www/third',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	617 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	618 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	619
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	620 To add name-based virtual hosts that answer on either 10.0.0.10 or 10.0.0.20, you must disable the Apache default `Listen 80`, as it conflicts with the preceding IP-based virtual hosts. To do this, set the [`add_listen`][] parameter to `false`:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	621
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	622 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	623 apache::vhost { 'fourth.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	624 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	625 docroot => '/var/www/fourth',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	626 add_listen => false,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	627 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	628
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	629 apache::vhost { 'fifth.example.com':
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	630 port => 80,
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	631 docroot => '/var/www/fifth',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	632 add_listen => false,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	633 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	634 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	635
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	636 ### Installing Apache modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	637
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	638 There are two ways to install [Apache modules][] using the Puppet apache module:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	639
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	640 - Use the [`apache::mod::<MODULE NAME>`][] classes to [install specific Apache modules with parameters][Installing specific modules].
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	641 - Use the [`apache::mod`][] defined type to [install arbitrary Apache modules][Installing arbitrary modules].
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	642
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	643 #### Installing specific modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	644
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	645 The Puppet apache module supports installing many common [Apache modules][], often with parameterized configuration options. For a list of supported Apache modules, see the [`apache::mod::<MODULE NAME>`][] class references.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	646
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	647 For example, you can install the `mod_ssl` Apache module with default settings by declaring the [`apache::mod::ssl`][] class:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	648
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	649 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	650 class { 'apache::mod::ssl': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	651 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	652
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	653 [`apache::mod::ssl`][] has several parameterized options that you can set when declaring it. For instance, to enable `mod_ssl` with compression enabled, set the [`ssl_compression`][] parameter to true:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	654
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	655 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	656 class { 'apache::mod::ssl':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	657 ssl_compression => true,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	658 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	659 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	660
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	661 Note that some modules have prerequisites, which are documented in their references under [`apache::mod::<MODULE NAME>`][].
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	662
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	663 #### Installing arbitrary modules
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	664
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	665 You can pass the name of any module that your operating system's package manager can install to the [`apache::mod`][] defined type to install it. Unlike the specific-module classes, the [`apache::mod`][] defined type doesn't tailor the installation based on other installed modules or with specific parameters---Puppet only grabs and installs the module's package, leaving detailed configuration up to you.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	666
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	667 For example, to install the [`mod_authnz_external`][] Apache module, declare the defined type with the 'mod_authnz_external' name:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	668
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	669 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	670 apache::mod { 'mod_authnz_external': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	671 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	672
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	673 There are several optional parameters you can specify when defining Apache modules this way. See the [defined type's reference][`apache::mod`] for details.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	674
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	675 <a id="load-balancing-examples"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	676 ### Load balancing examples
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	677
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	678 Apache supports load balancing across groups of servers through the [`mod_proxy`][] Apache module. Puppet supports configuring Apache load balancing groups (also known as balancer clusters) through the [`apache::balancer`][] and [`apache::balancermember`][] defined types.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	679
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	680 To enable load balancing with [exported resources][], export the [`apache::balancermember`][] defined type from the load balancer member server:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	681
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	682 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	683 @@apache::balancermember { "${::fqdn}-puppet00":
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	684 balancer_cluster => 'puppet00',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	685 url => "ajp://${::fqdn}:8009",
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	686 options => ['ping=5', 'disablereuse=on', 'retry=5', 'ttl=120'],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	687 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	688 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	689
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	690 Then, on the proxy server, create the load balancing group:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	691
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	692 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	693 apache::balancer { 'puppet00': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	694 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	695
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	696 To enable load balancing without exporting resources, declare the following on the proxy server:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	697
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	698 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	699 apache::balancer { 'puppet00': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	700
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	701 apache::balancermember { "${::fqdn}-puppet00":
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	702 balancer_cluster => 'puppet00',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	703 url => "ajp://${::fqdn}:8009",
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	704 options => ['ping=5', 'disablereuse=on', 'retry=5', 'ttl=120'],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	705 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	706 ```
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	707
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	708 Then declare the `apache::balancer` and `apache::balancermember` defined types on the proxy server.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	709
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	710 To use the [ProxySet](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyset) directive on the balancer, use the [`proxy_set`](#proxy_set) parameter of `apache::balancer`:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	711
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	712 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	713 apache::balancer { 'puppet01':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	714 proxy_set => {
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	715 'stickysession' => 'JSESSIONID',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	716 'lbmethod' => 'bytraffic',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	717 },
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	718 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	719 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	720
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	721 Load balancing scheduler algorithms (`lbmethod`) are listed [in mod_proxy_balancer documentation](https://httpd.apache.org/docs/current/mod/mod_proxy_balancer.html).
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	722
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	723 <a id="reference"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	724 ## Reference
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	725
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	726 For information on classes, types and functions see the [REFERENCE.md](https://github.com/puppetlabs/puppetlabs-apache/blob/main/REFERENCE.md)
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	727
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	728 ### Templates
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	729
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	730 The Apache module relies heavily on templates to enable the [`apache::vhost`][] and [`apache::mod`][] defined types. These templates are built based on [Facter][] facts that are specific to your operating system. Unless explicitly called out, most templates are not meant for configuration.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	731
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	732 ### Tasks
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	733
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	734 The Apache module has a task that allows a user to reload the Apache config without restarting the service. Please refer to to the [PE documentation](https://puppet.com/docs/pe/2017.3/orchestrator/running_tasks.html) or [Bolt documentation](https://puppet.com/docs/bolt/latest/bolt.html) on how to execute a task.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	735
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	736 <a id="limitations"></a>
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	737 ## Limitations
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	738
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	739 For an extensive list of supported operating systems, see [metadata.json](https://github.com/puppetlabs/puppetlabs-apache/blob/main/metadata.json)
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	740
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	741 ### FreeBSD
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	742
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	743 In order to use this module on FreeBSD, you _must_ use apache24-2.4.12 (www/apache24) or newer.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	744
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	745 ### Gentoo
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	746
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	747 On Gentoo, this module depends on the [`gentoo/puppet-portage`][] Puppet module. Although several options apply or enable certain features and settings for Gentoo, it is not a [supported operating system][] for this module.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	748
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	749 ### RHEL/CentOS
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	750
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	751 The [`apache::mod::auth_cas`][], [`apache::mod::passenger`][], [`apache::mod::proxy_html`][] and [`apache::mod::shib`][] classes are not functional on RH/CentOS without providing dependency packages from extra repositories.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	752
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	753 See their respective documentation below for related repositories and packages.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	754
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	755 #### RHEL/CentOS 5
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	756
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	757 The [`apache::mod::passenger`][] and [`apache::mod::proxy_html`][] classes are untested because repositories are missing compatible packages.
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	758
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	759 #### RHEL/CentOS 6
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	760
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	761 The [`apache::mod::passenger`][] class is not installing, because the EL6 repository is missing compatible packages.
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	762
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	763 #### RHEL/CentOS 7
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	764
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	765 The [`apache::mod::passenger`][] and [`apache::mod::proxy_html`][] classes are untested because the EL7 repository is missing compatible packages, which also blocks us from testing the [`apache::vhost`][] defined type's [`rack_base_uri`][] parameter.
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	766
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	767 ### SELinux and custom paths
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	768
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	769 If [SELinux][] is in [enforcing mode][] and you want to use custom paths for `logroot`, `mod_dir`, `vhost_dir`, and `docroot`, you need to manage the files' context yourself.
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	770
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	771 You can do this with Puppet:
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	772
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	773 ``` puppet
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	774 exec { 'set_apache_defaults':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	775 command => 'semanage fcontext -a -t httpd_sys_content_t "/custom/path(/.*)?"',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	776 path => '/bin:/usr/bin/:/sbin:/usr/sbin',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	777 require => Package['policycoreutils-python'],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	778 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	779
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	780 package { 'policycoreutils-python':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	781 ensure => installed,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	782 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	783
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	784 exec { 'restorecon_apache':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	785 command => 'restorecon -Rv /apache_spec',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	786 path => '/bin:/usr/bin/:/sbin:/usr/sbin',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	787 before => Class['Apache::Service'],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	788 require => Class['apache'],
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	789 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	790
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	791 class { 'apache': }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	792
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	793 host { 'test.server':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	794 ip => '127.0.0.1',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	795 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	796
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	797 file { '/custom/path':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	798 ensure => directory,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	799 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	800
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	801 file { '/custom/path/include':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	802 ensure => present,
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	803 content => '#additional_includes',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	804 }
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	805
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	806 apache::vhost { 'test.server':
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	807 docroot => '/custom/path',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	808 additional_includes => '/custom/path/include',
675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	809 }
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	810 ```
956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	811
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	812 NOTE: On RHEL 8, the SELinux packages contained in `policycoreutils-python` have been replaced by the `policycoreutils-python-utils` package.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	813 See [here](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/considerations_in_adopting_rhel_8/index#selinux-python3_security) for more details.
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	814
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	815 You must set the contexts using `semanage fcontext` instead of `chcon` because Puppet's `file` resources reset the values' context in the database if the resource doesn't specify it.
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	816
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	817 <a id="development"></a>
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	818 ## Development
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	819
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	820 ### Testing
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	821
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	822 To run the unit tests, install the necessary gems:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	823
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	824 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	825 bundle install
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	826 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	827
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	828 And then execute the command:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	829
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	830 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	831 bundle exec rake parallel_spec
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	832 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	833
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	834 To check the code coverage, run:
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	835
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	836 ```
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	837 COVERAGE=yes bundle exec rake parallel_spec
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	838 ```
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	839
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	840
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	841
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	842 Acceptance tests for this module leverage [puppet_litmus](https://github.com/puppetlabs/puppet_litmus).
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	843 To run the acceptance tests follow the instructions [here](https://puppetlabs.github.io/litmus/Running-acceptance-tests.html). You can also find a tutorial and walkthrough of using Litmus and the PDK on [YouTube](https://www.youtube.com/watch?v=FYfR7ZEGHoE).
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	844
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	845 ### Development Support
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	846 If you run into an issue with this module, or if you would like to request a feature, please [file a ticket](https://tickets.puppetlabs.com/browse/MODULES/).
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	847 Every Monday the Puppet IA Content Team has [office hours](https://puppet.com/community/office-hours) in the [Puppet Community Slack](http://slack.puppet.com/), alternating between an EMEA friendly time (1300 UTC) and an Americas friendly time (0900 Pacific, 1700 UTC).
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	848
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	849 If you have problems getting this module up and running, please [contact Support](http://puppetlabs.com/services/customer-support).
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	850
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	851 If you submit a change to this module, be sure to regenerate the reference documentation as follows:
257 675c1cc61eaf Update Apache module to get CentOS 8 support IBBoard <dev@ibboard.co.uk> parents: 36 diff changeset	852
275 d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	853 ```bash
d9352a684e62 Mass update of modules to remove deprecation warnings IBBoard <dev@ibboard.co.uk> parents: 257 diff changeset	854 puppet strings generate --format markdown --out REFERENCE.md
0 956e484adc12 Initial public release of Puppet configs IBBoard <dev@ibboard.co.uk> parents: diff changeset	855 ```
437 b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	856
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	857 ### Apache MOD Test & Support Lifecycle
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	858 #### Adding Support for a new Apache MOD
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	859 Support for new [Apache Modules] can be added under the [`apache::mod`] namespace.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	860 Acceptance tests should be added for each new [Apache Module][Apache Modules] added.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	861 Ideally, the acceptance tests should run on all compatible platforms that this module is supported on (see `metdata.json`), however there are cases when a more niche module is difficult to set up and install on a particular Linux distro.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	862 This could be for one or more of the following reasons:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	863 - Package not available in default repositories of distro
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	864 - Package dependencies not available in default repositories of distro
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	865 - Package (and/or its dependencies) are only available in a specific version of an OS
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	866
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	867 In these cases, it is possible to exclude a module from a test platform using a specific tag, defined above the class declaration:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	868 ```puppet
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	869 # @note Unsupported platforms: OS: ver, ver; OS: ver, ver, ver; OS: all
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	870 class apache::mod::foobar {
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	871 ...
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	872 }
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	873 ```
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	874 For example:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	875 ```puppet
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	876 # @note Unsupported platforms: RedHat: 5, 6; Ubuntu: 14.04; SLES: all; Scientific: 11 SP1
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	877 class apache::mod::actions {
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	878 ...
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	879 }
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	880 ```
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	881 Please be aware of the following format guidelines for the tag:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	882 - All OS/Version declarations must be preceded with `@note Unsupported platforms:`
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	883 - The tag must be declared ABOVE the class declaration (i.e. not as footer at the bottom of the file)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	884 - Each OS/Version declaration must be separated by semicolons (`;`)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	885 - Each version must be separated by a comma (`,`)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	886 - Versions CANNOT be declared in ranges (e.g. `RedHat:5-7`), they should be explicitly declared (e.g. `RedHat:5,6,7`)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	887 - However, to declare all versions of an OS as unsupported, use the word `all` (e.g. `SLES:all`)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	888 - OSs with word characters as part of their versions are acceptable (e.g. `Scientific: 11 SP1, 11 SP2, 12, 13`)
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	889 - Spaces are permitted between OS/Version declarations and version numbers within a declaration
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	890 - Refer to the `operatingsystem_support` values in the `metadata.json` to find the acceptable OS name and version syntax:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	891 - E.g. `OracleLinux` OR `oraclelinux`, not: `Oracle` or `OraLinux`
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	892 - E.g. `RedHat` OR `redhat`, not: `Red Hat Enterprise Linux`, `RHEL`, or `Red Hat`
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	893
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	894 If the tag is incorrectly formatted, a warning will be printed out at the end of the test run, indicating what tag(s) could not be parsed.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	895 This will not halt the execution of other tests.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	896
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	897 Once the class is tagged, it is possible to exclude a test for that particular [Apache MOD][Apache Modules] using RSpec's filtering and a helper method:
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	898 ```ruby
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	899 describe 'auth_oidc', if: mod_supported_on_platform('apache::mod::auth_openidc') do
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	900 ```
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	901 The `mod_supported_on_platform` helper method takes the [Apache Module][Apache Modules] class definition as defined in the manifests under `manifest/mod`.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	902
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	903 This functionality can be disabled by setting the `DISABLE_MOD_TEST_EXCLUSION` environment variable.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	904 When set, all exclusions will be ignored.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	905 #### Test Support Lifecycle
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	906 The puppetlabs-apache module supports a large number of compatible platforms and [Apache Modules][Apache modules].
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	907 As a result, Apache Module tests can fail because a package or package dependency has been removed from a Linux distribution repository.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	908 The [IAC Team][IAC Team] will try to resolve these issues and keep instructions updated, but due to limited resources this won’t always be possible.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	909 In these cases, we will exclude test(s) from certain platforms.
b8d6ada284dd Update Apache module to latest version IBBoard <dev@ibboard.co.uk> parents: 275 diff changeset	910 As always, we welcome help from our community members, and the IAC team is here to assist and answer questions.

Mercurial > repos > other > Puppet

annotate modules/apache/README.md @ 448:460bf6514bd8