Puppet Class: prometheus::unbound_exporter

Inherits:
prometheus
Defined in:
manifests/unbound_exporter.pp

Summary

This module manages prometheus unbound exporter. The exporter needs to be compiled by hand! (https://github.com/kumina/unbound_exporter/issues/21)

Overview

Parameters:

  • arch (String[1]) (defaults to: $prometheus::real_arch) —

    Architecture

  • bin_dir (Stdlib::Absolutepath) (defaults to: '/usr/local/bin') —

    Directory where binaries are located

  • download_extension (String) (defaults to: '') —

    Extension for the release binary archive

  • download_url (Optional[Prometheus::Uri]) (defaults to: undef) —

    Complete URL corresponding to the where the release binary archive can be downloaded

  • download_url_base (Prometheus::Uri) (defaults to: 'https://github.com/kumina/unbound_exporter/releases') —

    Base URL for the binary archive

  • extra_groups (Array[String]) (defaults to: ['unbound']) —

    Extra groups to add the binary user to

  • extra_options (String) (defaults to: '') —

    Extra options added to the startup command

  • group (String[1]) (defaults to: 'unbound-exporter') —

    Group under which the binary is running

  • init_style (Prometheus::Initstyle) (defaults to: $facts['service_provider']) —

    Service startup scripts style (e.g. rc, upstart or systemd)

  • install_method (Prometheus::Install) (defaults to: 'none') —

    Installation method: url or package (only url is supported currently)

  • manage_group (Boolean) (defaults to: true) —

    Whether to create a group for or rely on external code for that

  • manage_service (Boolean) (defaults to: true) —

    Should puppet manage the service?

  • manage_user (Boolean) (defaults to: true) —

    Whether to create user or rely on external code for that

  • os (String[1]) (defaults to: downcase($facts['kernel'])) —

    Operating system (linux is the only one supported)

  • package_ensure (String[1]) (defaults to: 'installed') —

    If package, then use this for package ensure

  • package_name (String[1]) (defaults to: 'unbound_exporter') —

    The binary package name - not available yet

  • purge_config_dir (Boolean) (defaults to: true) —

    Purge config files no longer generated by Puppet

  • restart_on_change (Boolean) (defaults to: true) —

    Should puppet restart the service on configuration change?

  • service_enable (Boolean) (defaults to: true) —

    Whether to enable the service from puppet

  • service_ensure (Stdlib::Ensure::Service) (defaults to: 'running') —

    State ensured for the service

  • service_name (String[1]) (defaults to: 'unbound_exporter') —

    Name of the unbound exporter service

  • user (String[1]) (defaults to: 'unbound-exporter') —

    User which runs the service

  • version (String[1]) (defaults to: '0.3') —

    The binary release version

  • export_scrape_job (Boolean) (defaults to: false)
  • scrape_port (Stdlib::Port) (defaults to: 9167)
  • scrape_job_name (String[1]) (defaults to: 'unbound')
  • scrape_job_labels (Optional[Hash]) (defaults to: undef)
  • bin_name (Optional[String[1]]) (defaults to: undef)
  • env_vars (Hash) (defaults to: { 'GODEBUG' => 'x509ignoreCN=0' })

See Also:

Author:

  • Tim Meusel <tim@bastelfreak.de>



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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
 
# File 'manifests/unbound_exporter.pp', line 55

class prometheus::unbound_exporter (
  String $download_extension              = '',
  Prometheus::Uri $download_url_base      = 'https://github.com/kumina/unbound_exporter/releases',
  Array[String] $extra_groups             = ['unbound'],
  String[1] $group                        = 'unbound-exporter',
  String[1] $package_ensure               = 'installed',
  String[1] $package_name                 = 'unbound_exporter',
  String[1] $user                         = 'unbound-exporter',
  String[1] $version                      = '0.3',
  Boolean $purge_config_dir               = true,
  Boolean $restart_on_change              = true,
  Boolean $service_enable                 = true,
  Stdlib::Ensure::Service $service_ensure = 'running',
  String[1] $service_name                 = 'unbound_exporter',
  Prometheus::Initstyle $init_style       = $facts['service_provider'],
  Prometheus::Install $install_method     = 'none',
  Boolean $manage_group                   = true,
  Boolean $manage_service                 = true,
  Boolean $manage_user                    = true,
  String[1] $os                           = downcase($facts['kernel']),
  String $extra_options                   = '',
  Optional[Prometheus::Uri] $download_url = undef,
  String[1] $arch                         = $prometheus::real_arch,
  Stdlib::Absolutepath $bin_dir           = '/usr/local/bin',
  Boolean $export_scrape_job              = false,
  Stdlib::Port $scrape_port               = 9167,
  String[1] $scrape_job_name              = 'unbound',
  Optional[Hash] $scrape_job_labels       = undef,
  Optional[String[1]] $bin_name           = undef,
  Hash $env_vars                          = { 'GODEBUG' => 'x509ignoreCN=0' },
) inherits prometheus {
  $real_download_url = pick($download_url,"${download_url_base}/download/${version}/${package_name}-${version}_${os}_${arch}")

  $notify_service = $restart_on_change ? {
    true    => Service[$service_name],
    default => undef,
  }

  prometheus::daemon { $service_name:
    install_method     => $install_method,
    version            => $version,
    download_extension => $download_extension,
    os                 => $os,
    arch               => $arch,
    real_download_url  => $real_download_url,
    bin_dir            => $bin_dir,
    notify_service     => $notify_service,
    package_name       => $package_name,
    package_ensure     => $package_ensure,
    manage_user        => $manage_user,
    user               => $user,
    extra_groups       => $extra_groups,
    group              => $group,
    manage_group       => $manage_group,
    purge              => $purge_config_dir,
    options            => $extra_options,
    init_style         => $init_style,
    service_ensure     => $service_ensure,
    service_enable     => $service_enable,
    manage_service     => $manage_service,
    export_scrape_job  => $export_scrape_job,
    scrape_port        => $scrape_port,
    scrape_job_name    => $scrape_job_name,
    scrape_job_labels  => $scrape_job_labels,
    bin_name           => $bin_name,
    env_vars           => $env_vars,
  }
}