Defined Type: apache::conf

Defined in:
puppet/modules/apache/manifests/conf.pp

Overview

Define: apache::conf

Manages Apache configuration snippets. This is a very thin wrapper around a File resource for a /etc/apache2/conf,sites-available config file and a symlink pointing to it in /etc/apache/conf,sites-enabled. By using it, you don't have to worry about dependencies and ordering; the resource will take care that Apache & all modules are provisioned before the conf is.

Parameters

ensure

If 'present', config will be enabled; if 'absent', disabled. The default is 'present'.

conf_type

Either 'sites' for a vhost config or 'conf' for instance-wide configs. The default is 'conf'.

priority

If you need this config to load before or after other configs, you can do so by manipulating this value. In most cases, the default value of 50 should be fine.

content

If defined, will be used as the content of the configuration file. Undefined by default. Mutually exclusive with 'source'.

source

Path to file containing configuration directives. Undefined by default. Mutually exclusive with 'content'.

Examples

apache::conf { 'blog.wikimedia.org':
  ensure  => present,
  content => template('blog/blog-apache-config.erb'),
}

Parameters:

  • ensure (Any) (defaults to: present)
  • conf_type (Any) (defaults to: 'conf')
  • priority (Any) (defaults to: 50)
  • content (Any) (defaults to: undef)
  • source (Any) (defaults to: undef)


39
40
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
# File 'puppet/modules/apache/manifests/conf.pp', line 39

define apache::conf(
    $ensure    = present,
    $conf_type = 'conf',
    $priority  = 50,
    $content   = undef,
    $source    = undef,
) {
    include ::apache

    if $priority !~ Integer[0, 99] {
        fail('"priority" must be between 0 - 99')
    }
    if $ensure !~ /^(present|absent)$/ {
        fail('"ensure" must be "present" or "absent"')
    }
    if $conf_type !~ /^(conf|sites)$/ {
        fail('"conf_type" must be "conf" or "sites"')
    }
    if $source == undef and $content == undef {
        fail('you must provide either "source" or "content"')
    }
    if $source != undef and $content != undef {
        fail('"source" and "content" are mutually exclusive')
    }

    $title_safe  = regsubst($title, '[\W_]', '-', 'G')
    $conf_file   = sprintf('%02d-%s.conf', $priority, $title_safe)
    $link_ensure = $ensure ? {
        present => link,
        default => absent,
    }

    file { "/etc/apache2/${conf_type}-available/${conf_file}":
        ensure  => $ensure,
        content => $content,
        source  => $source,
        owner   => 'root',
        group   => 'root',
        mode    => '0444',
    }

    file { "/etc/apache2/${conf_type}-enabled/${conf_file}":
        ensure => $link_ensure,
        target => "/etc/apache2/${conf_type}-available/${conf_file}",
        notify => Service['apache2'],
        owner  => 'root',
        group  => 'root',
        mode   => '0444',
    }
}