Puppet Plan: peadm::misc::divert_code_manager

Defined in:
plans/misc/divert_code_manager.pp

Summary

This plan exists to account for a scenario where a PE XL

Overview

architecture is in use, but code manager is not.

The PE DR solution technically requires code manager be enabled and running. However, in unusual circumstances, it may not be possible for a customer to actually use code manager. This plan allows DR to be used by leaving file-sync turned on, but directing file-sync to deploy code to a non-standard, unused directory. This leaves the Puppet codedir available for management via an alternative means.

This is a stop-gap at best. This should not be attempted without advisement.

Parameters:

  • primary_host (Any) 


15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'plans/misc/divert_code_manager.pp', line 15

plan peadm::misc::divert_code_manager (
  $primary_host,
) {
# lint:ignore:strict_indent
  notice(@(HEREDOC))
    The code manager puppet-code live-dir will be diverted
      from: /etc/puppetlabs/code
      to:   /etc/puppetlabs/code-synchronized
    This will allow /etc/puppetlabs/code to be managed manually
    | HEREDOC

  run_task('peadm::divert_code_manager', $primary_host)

  notice(@(HEREDOC))
    Remember to enforce this configuration in your Puppet code with a Collector Override. E.g.

      Pe_hocon_setting <| title == 'file-sync.repos.puppet-code.live-dir' |> {
        value => '/etc/puppetlabs/code-synchronized',
      }

    Remember also to disable static catalogs or configure static catalogs for
    use without file-sync. This can be done with a Hiera setting in pe.conf or
    the console:

      puppet_enterprise::master::static_catalogs: false

    Further documentation on static catalogs:
      https://puppet.com/docs/pe/2018.1/static_catalogs.html

    | HEREDOC
# lint:endignore
  return('Plan completed successfully')
}