Defined Type: nginx::resource::upstream::member

Defined in:
manifests/resource/upstream/member.pp

Overview

Define: nginx::resources::upstream::member

Creates an upstream member inside the upstream block. Export this resource in all upstream member servers and collect them on the NGINX server.

Requirements:

Requires storeconfigs on the Puppet Master to export and collect resources

Parameters:

[*upstream*]                - The name of the upstream resource
[*server*]                  - Hostname or IP of the upstream member server
[*port*]                    - Port of the listening service on the upstream member
[*upstream_fail_timeout*]   - Set the fail_timeout for the upstream. Default is 10 seconds

Examples:

Exporting the resource on a upstream member server:

@@nginx::resource::upstream::member { $::fqdn:
  upstream  => 'proxypass',
  server    => $::ipaddress,
  port      => '3000',
}

Collecting the resource on the NGINX server:

nginx::resource::upstream { 'proxypass':
  ensure    => present,
}

Parameters:

  • upstream (Any)
  • server (Any)
  • port (Any) (defaults to: '80')
  • upstream_fail_timeout (Any) (defaults to: '10s') 


35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'manifests/resource/upstream/member.pp', line 35

define nginx::resource::upstream::member (
  $upstream,
  $server,
  $port                   = '80',
  $upstream_fail_timeout  = '10s',
) {

  # Uses: $server, $port, $upstream_fail_timeout
  concat::fragment { "${upstream}_upstream_member_${name}":
    target  => "${::nginx::config::conf_dir}/conf.d/${upstream}-upstream.conf",
    order   => 40,
    content => template('nginx/conf.d/upstream_member.erb'),
  }
}