Defined Type: conftool::scripts::safe_service_restart

Defined in:
modules/conftool/manifests/scripts/safe_service_restart.pp

Overview

define conftool::scripts::safe_service_restart

Creates a safe service restart script for the titled resource.

What this script will do:

  • Depool, only if pooled, the server from the $lvs_pools listed

  • Verify the load balancers have effectively depooled the server, trying repeatedly

  • Restart the service with name $title

  • Repool, only if previously pooled, the server in the pools listed

  • Verify the load balancers effectively repooled the server

The advantages with respect to the older pooler-loop script we used to use is we allow more than one lvs pool to be depooled, and that we use conftool as a library so we have more control on our interaction with it.

Parameters

lvs_pools

names of the lvs pools we want to depool

services

The relevant part of the service catalog

lvs_class_hosts

LVS hosts classes, as defined in lvs::configuration::lvs_class_hosts.

If no pool is provided, or the realm is not production, the restart scripts will not use conftool and will just be a stub.

Parameters:

  • lvs_pools (Array[String])
  • services (Hash[String, Wmflib::Service])
  • lvs_class_hosts (Hash) 


25
26
27
28
29
30
31
32
33
34
35
36
37
38
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
 
# File 'modules/conftool/manifests/scripts/safe_service_restart.pp', line 25

define conftool::scripts::safe_service_restart(
    Array[String] $lvs_pools,
    Hash[String, Wmflib::Service] $services,
    Hash $lvs_class_hosts,
) {
    # Only require the other conftool scrips if lvs pools are declared.
    if $lvs_pools != [] {
        require ::conftool::scripts
        # Find the base cli arguments shared by all scripts.
        $uris = $lvs_pools.map |$pool| {
            $service = $services[$pool]
            $port = $service['port']
            $lvs_class_hosts[$service['lvs']['class']].map |$host| { "http://${host}:9090/pools/${pool}_${port}" }
#            $uris, [$service['conftool']['service']]]
        }
        .flatten().unique().join(' ')
        $pools = $lvs_pools.map |$pool| {
            $services[$pool]['lvs']['conftool']['service']
        }.unique().join(' ')
        $base_cli_args = "--lvs-urls ${uris} --pools ${pools}"
        # TODO: move to sbin as well. Now here for historical reasons.
        file { "/usr/local/bin/depool-${title}":
            ensure  => present,
            owner   => 'root',
            group   => 'root',
            mode    => '0555',
            content => template('conftool/safe-depool.erb')
        }

        file { "/usr/local/bin/pool-${title}":
            ensure  => present,
            owner   => 'root',
            group   => 'root',
            mode    => '0555',
            content => template('conftool/safe-pool.erb')
        }
    }
    # This file will be created independently of the presence of pools to remove or not.
    file { "/usr/local/sbin/restart-${title}":
        ensure  => present,
        content => template('conftool/safe-restart.erb'),
        owner   => 'root',
        group   => 'root',
        mode    => '0555',
    }

}