Defined Type: nginx::site

Defined in:
modules/nginx/manifests/site.pp

Overview

SPDX-License-Identifier: Apache-2.0

Define: nginx::site

Provisions an Nginx vhost. Like file resources, this resource type takes either a 'content' parameter with a string literal value or 'source' parameter with a Puppet file reference. The resource title is used as the site name.

Parameters

content

The Nginx site configuration as a string literal. Either this or 'source' must be set.

source

The Nginx site configuration as a Puppet file reference. Either this or 'content' must be set.

ensure

'present' or 'absent'; whether the site configuration is installed or removed in sites-available/

Examples

nginx::site { 'graphite':
  content => template('graphite/graphite.nginx.erb'),
}

Parameters:

  • ensure (Wmflib::Ensure) (defaults to: 'present')
  • content (Optional[String]) (defaults to: undef)
  • source (Optional[Stdlib::Filesource]) (defaults to: undef) 


29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'modules/nginx/manifests/site.pp', line 29

define nginx::site(
    Wmflib::Ensure               $ensure  = 'present',
    Optional[String]             $content = undef,
    Optional[Stdlib::Filesource] $source  = undef,
){

    include nginx

    $basename = regsubst($title, '[\W_]', '-', 'G')

    file { "/etc/nginx/sites-available/${basename}":
        ensure  => $ensure,
        content => $content,
        source  => $source,
        notify  => Exec['nginx-reload'],
    }

    file { "/etc/nginx/sites-enabled/${basename}":
        ensure => stdlib::ensure($ensure, 'link'),
        target => "/etc/nginx/sites-available/${basename}",
    }
}