Puppet Class: apache::mod::status

Inherits:
::apache::params
Defined in:
manifests/mod/status.pp

Summary

Installs and configures `mod_status`.

Overview

Examples:

# Simple usage allowing access from localhost and a private subnet
class { 'apache::mod::status':
  $allow_from => ['127.0.0.1', '10.10.10.10/24'],
}

Parameters:

  • allow_from (Optional[Array]) (defaults to: undef) —

    Array of hosts, ip addresses, partial network numbers or networks, in CIDR notation specifying what hosts can view the special /server-status URL. Defaults to [‘127.0.0.1’, ‘::1’]. > Creates Apache < 2.4 directive “Allow from”.

  • requires (Optional[Variant[String, Array, Hash]]) (defaults to: undef) —

    A Variant type that can be:

    • String with:

      • ” or ‘unmanaged’ - Host auth control done elsewhere

      • ‘ip <List of IPs>’ - Allowed IPs/ranges

      • ‘host <List of names>’ - Allowed names/domains

      • ‘all [granted|denied]’

    • Array of strings with ip or host as above

    • Hash with following keys:

      • ‘requires’ - Value => Array as above

      • ‘enforce’ - Value => String ‘Any’, ‘All’ or ‘None’ This encloses “Require” directives in “<Require(Any|All|None)>” block Optional - If unspecified, “Require” directives follow current flow

    > Creates Apache >= 2.4 directives “Require”

  • extended_status (Enum['On', 'Off', 'on', 'off']) (defaults to: 'On') —

    Determines whether to track extended status information for each request, via the ExtendedStatus directive.

  • status_path (Any) (defaults to: '/server-status') —

    Path assigned to the Location directive which defines the URL to access the server status.

  • apache_version (Any) (defaults to: undef) —

    Used to verify that the Apache version you have requested is compatible with the module.

See Also:



41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'manifests/mod/status.pp', line 41

class apache::mod::status (
  Optional[Array] $allow_from                      = undef,
  Optional[Variant[String, Array, Hash]] $requires = undef,
  Enum['On', 'Off', 'on', 'off'] $extended_status  = 'On',
  $apache_version                                  = undef,
  $status_path                                     = '/server-status',
) inherits ::apache::params {

  include ::apache
  $_apache_version = pick($apache_version, $apache::apache_version)
  ::apache::mod { 'status': }

  # Defaults for "Allow from" or "Require" directives
  $allow_defaults = ['127.0.0.1','::1']
  $requires_defaults = 'ip 127.0.0.1 ::1'

  # Template uses $allow_from, $extended_status, $_apache_version, $status_path
  file { 'status.conf':
    ensure  => file,
    path    => "${::apache::mod_dir}/status.conf",
    mode    => $::apache::file_mode,
    content => template('apache/mod/status.conf.erb'),
    require => Exec["mkdir ${::apache::mod_dir}"],
    before  => File[$::apache::mod_dir],
    notify  => Class['apache::service'],
  }
}