1
2
3
4
5
6
7
8
9
10
11
12
13
14
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
48
49
50
51
52
53
54
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
|
# == Class: puppet
#
# This class installs and configures the puppet agent.
#
# === Parameters:
#
# $show_diff:: Show and report changed files with diff output
#
# $ca_server:: Use a different ca server. Should be either
# a string with the location of the ca_server
# or 'false'.
#
# == Advanced puppet parameters
#
# $version:: Specify a specific version of a package to
# install. The version should be the exact
# match for your distro.
# You can also use certain values like 'latest'.
# Note that when you specify exact versions you
# should also override $server_version since
# that defaults to $version.
#
# $manage_packages:: Should this module install packages or not.
# Can also install only server packages with value
# of 'server' or only agent packages with 'agent'.
#
# $agent_server_port:: Override the port of the server we connect to.
#
# $splay:: Switch to enable a random amount of time
# to sleep before each run.
#
# $splaylimit:: The maximum time to delay before runs.
# Defaults to being the same as the run interval.
# This setting can be a time interval in seconds
# (30 or 30s), minutes (30m), hours (6h), days (2d),
# or years (5y).
#
# $runinterval:: Set up the interval (in seconds) to run
# the puppet agent.
#
# $autosign:: If set to a boolean, autosign is enabled or disabled
# for all incoming requests. Otherwise this has to be
# set to the full file path of an autosign.conf file or
# an autosign script. If this is set to a script, make
# sure that script considers the content of autosign.conf
# as otherwise Foreman functionality might be broken.
#
# $autosign_entries:: A list of certnames or domain name globs
# whose certificate requests will automatically be signed.
# Defaults to an empty Array.
#
# $autosign_mode:: mode of the autosign file/script
#
# $autosign_content:: If set, write the autosign file content
# using the value of this parameter.
# Cannot be used at the same time as autosign_entries
# For example, could be a string, or
# file('another_module/autosign.sh') or
# template('another_module/autosign.sh.erb')
#
# $autosign_source:: If set, use this as the source for the autosign file,
# instead of autosign_content.
#
# $usecacheonfailure:: Switch to enable use of cached catalog on
# failure of run.
#
# $runmode:: Select the mode to setup the puppet agent.
#
# $run_hour:: The hour at which to run the puppet agent
# when runmode is cron or systemd.timer.
#
# $run_minute:: The minute at which to run the puppet agent
# when runmode is cron or systemd.timer.
#
# $cron_cmd:: Specify command to launch when runmode is
# set 'cron'.
#
# $systemd_cmd:: Specify command to launch when runmode is
# set 'systemd.timer'.
#
# $systemd_randomizeddelaysec:: Adds a random delay between 0 and this value
# (in seconds) to the timer. Only relevant when
# runmode is 'systemd.timer'.
#
# $module_repository:: Use a different puppet module repository
#
# $ca_port:: Puppet CA port
#
# $ca_crl_filepath:: Path to CA CRL file, dynamically resolves based on
# $::server_ca status.
#
# $dns_alt_names:: Use additional DNS names when generating a
# certificate. Defaults to an empty Array.
#
# $hiera_config:: The hiera configuration file.
#
# $localconfig:: The localconfig setting.
#
# $syslogfacility:: Facility name to use when logging to syslog
#
# $use_srv_records:: Whether DNS SRV records will be used to resolve
# the Puppet server
#
# $srv_domain:: Search domain for SRV records
#
# $additional_settings:: A hash of additional main settings.
#
# $http_connect_timeout:: The maximum amount of time an agent waits
# when establishing an HTTP connection.
#
# $http_read_timeout:: The time an agent waits for one block to be
# read from an HTTP connection. If nothing is
# read after the elapsed interval then the
# connection will be closed.
#
# $user:: Override the name of the puppet user.
#
# $group:: Override the name of the puppet group.
#
# $dir:: Override the puppet directory.
#
# $codedir:: Override the puppet code directory.
#
# $vardir:: Override the puppet var directory.
#
# $logdir:: Override the log directory.
#
# $rundir:: Override the PID directory.
#
# $ssldir:: Override where SSL certificates are kept.
#
# $sharedir:: Override the system data directory.
#
# $package_provider:: The provider used to install the agent.
# Defaults to chocolatey on Windows
# Defaults to undef elsewhere
#
# $package_source:: The location of the file to be used by the
# agent's package resource.
# Defaults to undef. If 'windows' or 'msi' are
# used as the provider then this setting is
# required.
# $package_install_options:: Flags that should be passed to the package manager
# during installation. Defaults to undef. May be
# a string, an array or a hash, see Puppet Package resource
# documentation for the provider matching your package manager
#
# $unavailable_runmodes:: Runmodes that are not available for the
# current system. This module will not try
# to disable these modes. Default is []
# on Linux, ['cron', 'systemd.timer'] on
# Windows and ['systemd.timer'] on other
# systems.
#
# $pluginsource:: URL to retrieve Puppet plugins from during pluginsync
#
# $pluginfactsource:: URL to retrieve Puppet facts from during pluginsync
#
# $classfile:: The file in which puppet agent stores a list
# of the classes associated with the retrieved
# configuration.
#
# $puppetconf_mode:: The permissions for /etc/puppetlabs/puppet/puppet.conf
# default to '0644' and '0674' on windows
#
# == puppet::agent parameters
#
# $agent:: Should a puppet agent be installed
#
# $agent_noop:: Run the agent in noop mode.
#
# $agent_server_hostname:: Hostname of your puppetserver (server
# directive in puppet.conf)
#
# $prerun_command:: A command which gets excuted before each Puppet run
#
# $postrun_command:: A command which gets excuted after each Puppet run
#
# $environment:: Default environment of the Puppet agent
#
# $agent_default_schedules:: A boolean to enable/disable the default schedules
#
# $agent_additional_settings:: A hash of additional agent settings.
# Example: {stringify_facts => true}
#
# $client_certname:: The node's certificate name, and the unique
# identifier it uses when requesting catalogs.
#
# $report:: Send reports to the Puppet Master
#
# == advanced agent parameters
#
# $service_name:: The name of the puppet agent service.
#
# $agent_restart_command:: The command which gets excuted on puppet service restart
#
# $client_package:: Install a custom package to provide
# the puppet client
#
# $systemd_unit_name:: The name of the puppet systemd units.
#
# $dir_owner:: Owner of the base puppet directory, used when
# puppet::server is false.
#
# $dir_group:: Group of the base puppet directory, used when
# puppet::server is false.
#
# == puppet::server parameters
#
# $server:: Should a puppet server be installed as well as the client
#
# $server_ip:: Bind ip address of the puppetserver
#
# $server_port:: Puppet server port
#
# $server_ca:: Provide puppet CA
#
# $server_ca_crl_sync:: Sync puppet CA crl file to compilers, Puppet CA Must be the Puppetserver
# for the compilers. Defaults to false.
#
# $server_crl_enable:: Turn on crl checking. Defaults to true when server_ca is true. Otherwise
# Defaults to false. Note unless you are using an external CA. It is recommended
# to set this to true. See $server_ca_crl_sync to enable syncing from CA Puppet Master
#
# $server_reports:: List of report types to include on the puppetserver
#
# $server_external_nodes:: External nodes classifier executable
#
# $server_trusted_external_command:: The external trusted facts script to use.
#
# $server_git_repo:: Use git repository as a source of modules
#
# $server_environments_owner:: The owner of the environments directory
#
# $server_environments_group:: The group owning the environments directory
#
# $server_environments_mode:: Environments directory mode.
#
# $server_environments_recurse:: Should the environments directory be managed recursively
#
# $server_common_modules_path:: Common modules paths
#
# $server_git_repo_path:: Git repository path on disk
#
# $server_git_repo_umask:: Umask used during git operations
#
# $server_git_repo_hook_mode:: Git repository hook mode
#
# $server_git_repo_group:: Git repository group
#
# $server_git_repo_user:: Git repository user
#
# $server_git_branch_map:: Git branch to puppet env mapping for the
# default post receive hook
#
# $server_storeconfigs:: Whether to enable storeconfigs
#
# $server_certname:: The name to use when handling certificates.
#
# === Advanced server parameters:
#
# $server_strict_variables:: if set to true, it will throw parse errors
# when accessing undeclared variables.
#
# $server_additional_settings:: A hash of additional settings.
# Example: {trusted_node_data => true, ordering => 'manifest'}
#
# $server_manage_user:: Whether to manage the server user resource
#
# $server_user:: Username used for the puppetserver process
#
# $server_group:: Group used for the puppetserver process
#
# $server_dir:: Puppet configuration directory
#
# $server_http:: Should the puppet server listen on HTTP as well as HTTPS.
# Useful for load balancer or reverse proxy scenarios.
#
# $server_http_port:: Puppet server HTTP port; defaults to 8139.
#
# $server_foreman_facts:: Should foreman receive facts from puppet
#
# $server_foreman:: Should foreman integration be installed
#
# $server_foreman_url:: Foreman URL
#
# $server_foreman_ssl_ca:: SSL CA of the Foreman server
#
# $server_foreman_ssl_cert:: Client certificate for authenticating against Foreman server
#
# $server_foreman_ssl_key:: Key for authenticating against Foreman server
#
# $server_puppet_basedir:: Where is the puppet code base located
#
# $server_request_timeout:: Timeout in node.rb script for fetching
# catalog from Foreman (in seconds).
#
# $server_environment_timeout:: Timeout for cached compiled catalogs (10s, 5m, ...)
#
# $server_envs_dir:: List of directories which hold puppet environments
#
# $server_envs_target:: Indicates that $envs_dir should be
# a symbolic link to this target
#
# $server_jvm_java_bin:: Set the default java to use.
#
# $server_jvm_config:: Specify the puppetserver jvm configuration file.
#
# $server_jvm_min_heap_size:: Specify the minimum jvm heap space.
#
# $server_jvm_max_heap_size:: Specify the maximum jvm heap space.
#
# $server_jvm_extra_args:: Additional java options to pass through.
# This can be used for Java versions prior to
# Java 8 to specify the max perm space to use:
# For example: '-XX:MaxPermSize=128m'.
#
# $server_jvm_cli_args:: Java options to use when using puppetserver
# subcommands (eg puppetserver gem).
#
# $server_jruby_gem_home:: Where jruby gems are located for puppetserver
#
# $server_environment_vars:: A hash of environment variables and their values
# which the puppetserver is allowed to see.
# To define literal values double quotes should be used:
# {'MYVAR': '"MYVALUE"'}. Omitting the inner quotes
# might lead to unexpected results since the HOCON
# format does not allow characters like $,
# curly/square brackets or = in unquoted strings.
# Multi line strings are also allowed as long as they are
# triple quoted: {'MYVAR': "\"\"\"MY\nMULTI\nLINE\nVALUE\"\"\""}
# To pass an existing variable use substitutions: {'MYVAR': '${MYVAR}'}.
#
# $allow_any_crl_auth:: Allow any authentication for the CRL. This
# is needed on the puppet CA to accept clients
# from a the puppet CA proxy.
#
# $auth_allowed:: An array of authenticated nodes allowed to
# access all catalog and node endpoints.
# default to ['$1']
#
# $server_default_manifest:: Toggle if default_manifest setting should
# be added to the [main] section
#
# $server_default_manifest_path:: A string setting the path to the default_manifest
#
# $server_default_manifest_content:: A string to set the content of the default_manifest
# If set to '' it will not manage the file
#
# $server_package:: Custom package name for puppet server
#
# $server_version:: Custom package version for puppet server
#
# $server_ssl_dir:: SSL directory
#
# $server_ssl_dir_manage:: Toggle if ssl_dir should be added to the [server]
# configuration section. This is necessary to
# disable in case CA is delegated to a separate instance
#
# $server_ssl_key_manage:: Toggle if "private_keys/${::puppet::server::certname}.pem"
# should be created with default user and group. This is used in
# the default Forman setup to reuse the key for TLS communication.
#
# $server_puppetserver_vardir:: The path of the puppetserver var dir
#
# $server_puppetserver_rundir:: The path of the puppetserver run dir
#
# $server_puppetserver_logdir:: The path of the puppetserver log dir
#
# $server_puppetserver_dir:: The path of the puppetserver config dir
#
# $server_puppetserver_version:: The version of puppetserver installed (or being installed)
# Unfortunately, different versions of puppetserver need
# configuring differently. The default is derived from the
# installed puppet version. Generally it's not needed to
# override this but when upgrading it might be.
#
# $server_max_active_instances:: Max number of active jruby instances. Defaults to
# processor count
#
# $server_max_requests_per_instance:: Max number of requests a jruby instances will handle. Defaults to 0 (disabled)
#
# $server_max_queued_requests:: The maximum number of requests that may be queued waiting to borrow a
# JRuby from the pool.
# Defaults to 0 (disabled).
#
# $server_max_retry_delay:: Sets the upper limit for the random sleep set as a Retry-After header on
# 503 responses returned when max-queued-requests is enabled.
# Defaults to 1800.
#
# $server_multithreaded:: Use multithreaded jruby. Defaults to false.
#
# $server_idle_timeout:: How long the server will wait for a response on an existing connection
#
# $server_connect_timeout:: How long the server will wait for a response to a connection attempt
#
# $server_ssl_protocols:: Array of SSL protocols to use.
# Defaults to [ 'TLSv1.3', 'TLSv1.2' ]
#
# $server_ssl_chain_filepath:: Path to certificate chain for puppetserver
# Only used when $ca is true
# Defaults to "${ssl_dir}/ca/ca_crt.pem"
#
# $server_cipher_suites:: List of SSL ciphers to use in negotiation
# Defaults to ['TLS_AES_128_GCM_SHA256', 'TLS_AES_256_GCM_SHA384',
# 'TLS_DHE_RSA_WITH_AES_128_GCM_SHA256', 'TLS_DHE_RSA_WITH_AES_256_GCM_SHA384',
# 'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256', 'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384',
# 'TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256', 'TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384']
#
# $server_ruby_load_paths:: List of ruby paths
#
# $server_ca_client_allowlist:: The allowlist of client certificates that
# can query the certificate-status endpoint
# Defaults to [ '127.0.0.1', '::1', $::ipaddress ]
#
# $server_custom_trusted_oid_mapping:: A hash of custom trusted oid mappings. Defaults to undef
# Example: { 1.3.6.1.4.1.34380.1.2.1.1 => { shortname => 'myshortname' } }
#
# $server_admin_api_allowlist:: The allowlist of clients that
# can query the puppet-admin-api endpoint
# Defaults to [ '127.0.0.1', '::1', $::ipaddress ]
#
# $server_ca_auth_required:: Whether client certificates are needed to access the puppet-admin api
# Defaults to true
#
# $server_ca_client_self_delete:: Adds a rule to auth.conf, that allows a client to delete its own certificate
# Defaults to false
#
# $server_check_for_updates:: Should the puppetserver phone home to check for available updates?
# Defaults to true
#
# $server_post_hook_content:: Which template to use for git post hook
#
# $server_post_hook_name:: Name of a git hook
#
# $server_environment_class_cache_enabled:: Enable environment class cache in conjunction with the use of the
# environment_classes API.
# Defaults to false
#
# $server_allow_header_cert_info:: Enable client authentication over HTTP Headers
# Defaults to false, is also activated by the $server_http setting
#
# $server_web_idle_timeout:: Time in ms that Jetty allows a socket to be idle, after processing has
# completed.
# Defaults to 30000, using the Jetty default of 30s
#
# $server_puppetserver_metrics:: Enable puppetserver http-client metrics
#
# $server_puppetserver_profiler:: Enable JRuby profiling.
# If set to false, compiler and function metrics will not be available, (eg. when enabling graphite metrics)
#
# $server_puppetserver_telemetry:: Enable Dropsonde telemetry.
# Undef means disabled while booleans are explicit opt-in or opt-out.
# This is different from Puppetserver's default values.
#
# $server_metrics_jmx_enable:: Enable or disable JMX metrics reporter. Defaults to true
#
# $server_metrics_graphite_enable:: Enable or disable Graphite metrics reporter. Defaults to false
#
# $server_metrics_graphite_host:: Graphite server host. Defaults to "127.0.0.1"
#
# $server_metrics_graphite_port:: Graphite server port. Defaults to 2003
#
# $server_metrics_server_id:: A server id that will be used as part of the namespace for metrics produced
# Defaults to $fqdn
#
# $server_metrics_graphite_interval:: How often to send metrics to graphite (in seconds)
# Defaults to 5
#
# $server_metrics_allowed:: Specify metrics to allow in addition to those in the default list
# Defaults to undef
#
# $server_puppetserver_experimental:: Enable the /puppet/experimental route? Defaults to true
#
# $server_puppetserver_auth_template:: Template for generating /etc/puppetlabs/puppetserver/conf.d/auth.conf
#
# $server_puppetserver_trusted_agents:: Certificate names of puppet agents that are allowed to fetch *all* catalogs
# Defaults to [] and all agents are only allowed to fetch their own catalogs.
#
# $server_puppetserver_trusted_certificate_extensions:: An array of hashes of certificate extensions and values to be used in auth.conf
# A puppet client certificate containing valid extension(s) will be allowed to fetch
# *any* catalog.
# Defaults to [] and no certificate extensions are recognised as being allowed
# to fetch *any* catalog.
# Example: [{ 'pp_authorization' => 'catalog' }]
# Any client certificate containing the `pp_authorization` extension with value `catalog`
# will be permitted to fetch any catalog.
# Complicated example: [
# { '1.3.6.1.4.1.34380.1.3.1' => 'catalog' },
# { '1.3.6.1.4.1.34380.1.1.13' => 'jenkins_server', '1.3.6.1.4.1.34380.1.1.24' => 'prod' }
# ]
# Clients presenting a certificate with `pp_authorization = catalog` *or* with `pp_role`
# *and* `pp_apptier` extensions set
# correctly will be authorized to fetch any catalog.
# NB. If server_ca == false, use oids instead of extension shortnames.
# See https://tickets.puppetlabs.com/browse/SERVER-1689
#
# $server_compile_mode:: Used to control JRuby's "CompileMode", which may improve performance.
# Defaults to undef (off).
#
# $server_parser:: Sets the parser to use. Valid options are 'current' or 'future'.
# Defaults to 'current'.
#
# $server_acceptor_threads:: This sets the number of threads that the webserver will dedicate to accepting
# socket connections for unencrypted HTTP traffic. If not provided, the webserver
# defaults to the number of virtual cores on the host divided by 8, with a minimum
# of 1 and maximum of 4.
#
# $server_selector_threads:: This sets the number of selectors that the webserver will dedicate to processing
# events on connected sockets for unencrypted HTTPS traffic. If not provided,
# the webserver defaults to the minimum of: virtual cores on the host divided by 2
# or max-threads divided by 16, with a minimum of 1.
#
# $server_max_threads:: This sets the maximum number of threads assigned to responding to HTTP and/or
# HTTPS requests for a single webserver, effectively changing how many
# concurrent requests can be made at one time. If not provided, the
# webserver defaults to 200.
#
# $server_ssl_acceptor_threads:: This sets the number of threads that the webserver will dedicate to accepting
# socket connections for encrypted HTTPS traffic. If not provided, defaults to
# the number of virtual cores on the host divided by 8, with a minimum of 1 and maximum of 4.
#
# $server_ssl_selector_threads:: This sets the number of selectors that the webserver will dedicate to processing
# events on connected sockets for encrypted HTTPS traffic. Defaults to the number of
# virtual cores on the host divided by 2, with a minimum of 1 and maximum of 4.
# The number of selector threads actually used by Jetty is twice the number of selectors
# requested. For example, if a value of 3 is specified for the ssl-selector-threads setting,
# Jetty will actually use 6 selector threads.
#
# $server_ca_allow_sans:: Allow CA to sign certificate requests that have Subject Alternative Names
# Defaults to false
#
# $server_ca_allow_auth_extensions:: Allow CA to sign certificate requests that have authorization extensions
# Defaults to false
#
# $server_ca_enable_infra_crl:: Enable the separate CRL for Puppet infrastructure nodes
# Defaults to false
#
# $server_max_open_files:: Increase the max open files limit for Puppetserver.
# Defaults to undef
#
# $server_versioned_code_id:: The path to an executable script that Puppet Server invokes to generate a code_id
# Defaults to undef
#
# $server_versioned_code_content:: Contains the path to an executable script that Puppet Server
# invokes when on static_file_content requests.
# Defaults to undef
#
# $server_jolokia_metrics_allowlist:: The allowlist of clients that
# can query the jolokia /metrics/v2 endpoint
#
# === Usage:
#
# * Simple usage:
#
# include puppet
#
# * Installing a puppetserver
#
# class {'puppet':
# server => true,
# }
#
# * Advanced usage:
#
# class {'puppet':
# agent_noop => true,
# version => '7.24.0-1',
# }
#
class puppet (
String $version = $puppet::params::version,
String $user = $puppet::params::user,
String $group = $puppet::params::group,
Stdlib::Absolutepath $dir = $puppet::params::dir,
Stdlib::Absolutepath $codedir = $puppet::params::codedir,
Stdlib::Absolutepath $vardir = $puppet::params::vardir,
Stdlib::Absolutepath $logdir = $puppet::params::logdir,
Stdlib::Absolutepath $rundir = $puppet::params::rundir,
Stdlib::Absolutepath $ssldir = $puppet::params::ssldir,
Stdlib::Absolutepath $sharedir = $puppet::params::sharedir,
Variant[Boolean, Enum['server', 'agent']] $manage_packages = $puppet::params::manage_packages,
Optional[String] $dir_owner = $puppet::params::dir_owner,
Optional[String] $dir_group = $puppet::params::dir_group,
Optional[String] $package_provider = $puppet::params::package_provider,
Optional[Variant[String,Hash,Array]] $package_install_options = $puppet::params::package_install_options,
Optional[Variant[Stdlib::Absolutepath, Stdlib::HTTPUrl]] $package_source = $puppet::params::package_source,
Stdlib::Port $agent_server_port = $puppet::params::agent_server_port,
Boolean $splay = $puppet::params::splay,
Variant[Integer[0],Pattern[/^\d+[smhdy]?$/]] $splaylimit = $puppet::params::splaylimit,
Variant[Boolean, Stdlib::Absolutepath] $autosign = $puppet::params::autosign,
Array[String] $autosign_entries = $puppet::params::autosign_entries,
Pattern[/^[0-9]{3,4}$/] $autosign_mode = $puppet::params::autosign_mode,
Optional[String] $autosign_content = $puppet::params::autosign_content,
Optional[String] $autosign_source = $puppet::params::autosign_source,
Variant[Integer[0],Pattern[/^\d+[smhdy]?$/]] $runinterval = $puppet::params::runinterval,
Boolean $usecacheonfailure = $puppet::params::usecacheonfailure,
Enum['cron', 'service', 'systemd.timer', 'none', 'unmanaged'] $runmode = $puppet::params::runmode,
Optional[Integer[0,23]] $run_hour = undef,
Variant[Integer[0,59], Array[Integer[0,59]], Undef] $run_minute = undef,
Array[Enum['cron', 'service', 'systemd.timer', 'none']] $unavailable_runmodes = $puppet::params::unavailable_runmodes,
Optional[String] $cron_cmd = $puppet::params::cron_cmd,
Optional[String] $systemd_cmd = $puppet::params::systemd_cmd,
Integer[0] $systemd_randomizeddelaysec = $puppet::params::systemd_randomizeddelaysec,
Boolean $agent_noop = $puppet::params::agent_noop,
Boolean $agent_default_schedules = $puppet::params::agent_default_schedules,
Boolean $show_diff = $puppet::params::show_diff,
Optional[Stdlib::HTTPUrl] $module_repository = $puppet::params::module_repository,
Optional[Integer[0]] $http_connect_timeout = $puppet::params::http_connect_timeout,
Optional[Integer[0]] $http_read_timeout = $puppet::params::http_read_timeout,
Optional[Variant[String, Boolean]] $ca_server = $puppet::params::ca_server,
Optional[Stdlib::Port] $ca_port = $puppet::params::ca_port,
Optional[String] $ca_crl_filepath = $puppet::params::ca_crl_filepath,
Optional[String] $prerun_command = $puppet::params::prerun_command,
Optional[String] $postrun_command = $puppet::params::postrun_command,
Array[String] $dns_alt_names = $puppet::params::dns_alt_names,
Boolean $use_srv_records = $puppet::params::use_srv_records,
Optional[String] $srv_domain = $puppet::params::srv_domain,
String $pluginsource = $puppet::params::pluginsource,
String $pluginfactsource = $puppet::params::pluginfactsource,
Hash[String, Data] $additional_settings = $puppet::params::additional_settings,
Hash[String, Data] $agent_additional_settings = $puppet::params::agent_additional_settings,
Optional[String] $agent_restart_command = $puppet::params::agent_restart_command,
String $classfile = $puppet::params::classfile,
String $hiera_config = $puppet::params::hiera_config,
String $localconfig = $puppet::params::localconfig,
Boolean $allow_any_crl_auth = $puppet::params::allow_any_crl_auth,
Array[String] $auth_allowed = $puppet::params::auth_allowed,
Variant[String, Array[String]] $client_package = $puppet::params::client_package,
Boolean $agent = $puppet::params::agent,
Boolean $report = $puppet::params::report,
Variant[String, Boolean] $client_certname = $puppet::params::client_certname,
Optional[String] $agent_server_hostname = $puppet::params::agent_server_hostname,
String $systemd_unit_name = $puppet::params::systemd_unit_name,
String $service_name = $puppet::params::service_name,
Optional[String] $syslogfacility = $puppet::params::syslogfacility,
String $environment = $puppet::params::environment,
Boolean $server = $puppet::params::server,
Array[String] $server_admin_api_allowlist = $puppet::params::server_admin_api_allowlist,
Boolean $server_manage_user = $puppet::params::manage_user,
String $server_user = $puppet::params::user,
String $server_group = $puppet::params::group,
String $server_dir = $puppet::params::dir,
String $server_ip = $puppet::params::ip,
Stdlib::Port $server_port = $puppet::params::agent_server_port,
Boolean $server_ca = $puppet::params::server_ca,
Boolean $server_ca_crl_sync = $puppet::params::server_ca_crl_sync,
Optional[Boolean] $server_crl_enable = $puppet::params::server_crl_enable,
Boolean $server_ca_auth_required = $puppet::params::server_ca_auth_required,
Boolean $server_ca_client_self_delete = $puppet::params::server_ca_client_self_delete,
Array[String] $server_ca_client_allowlist = $puppet::params::server_ca_client_allowlist,
Optional[Puppet::Custom_trusted_oid_mapping] $server_custom_trusted_oid_mapping = $puppet::params::server_custom_trusted_oid_mapping,
Boolean $server_http = $puppet::params::server_http,
Stdlib::Port $server_http_port = $puppet::params::server_http_port,
String $server_reports = $puppet::params::server_reports,
Optional[Stdlib::Absolutepath] $server_puppetserver_dir = $puppet::params::server_puppetserver_dir,
Optional[Stdlib::Absolutepath] $server_puppetserver_vardir = $puppet::params::server_puppetserver_vardir,
Optional[Stdlib::Absolutepath] $server_puppetserver_rundir = $puppet::params::server_puppetserver_rundir,
Optional[Stdlib::Absolutepath] $server_puppetserver_logdir = $puppet::params::server_puppetserver_logdir,
Optional[Pattern[/^[\d]\.[\d]+\.[\d]+$/]] $server_puppetserver_version = $puppet::params::server_puppetserver_version,
Variant[Undef, String[0], Stdlib::Absolutepath] $server_external_nodes = $puppet::params::server_external_nodes,
Optional[Stdlib::Absolutepath] $server_trusted_external_command = $puppet::params::server_trusted_external_command,
Array[String] $server_cipher_suites = $puppet::params::server_cipher_suites,
Integer[0] $server_connect_timeout = $puppet::params::server_connect_timeout,
Boolean $server_git_repo = $puppet::params::server_git_repo,
Boolean $server_default_manifest = $puppet::params::server_default_manifest,
Stdlib::Absolutepath $server_default_manifest_path = $puppet::params::server_default_manifest_path,
String $server_default_manifest_content = $puppet::params::server_default_manifest_content,
String $server_environments_owner = $puppet::params::server_environments_owner,
Optional[String] $server_environments_group = $puppet::params::server_environments_group,
Pattern[/^[0-9]{3,4}$/] $server_environments_mode = $puppet::params::server_environments_mode,
Boolean $server_environments_recurse = $puppet::params::server_environments_recurse,
Array[Stdlib::Absolutepath, 1] $server_envs_dir = $puppet::params::server_envs_dir,
Optional[Stdlib::Absolutepath] $server_envs_target = $puppet::params::server_envs_target,
Variant[Undef, String[0], Array[Stdlib::Absolutepath]] $server_common_modules_path = $puppet::params::server_common_modules_path,
Pattern[/^[0-9]{3,4}$/] $server_git_repo_hook_mode = $puppet::params::server_git_repo_hook_mode,
Stdlib::Absolutepath $server_git_repo_path = $puppet::params::server_git_repo_path,
Pattern[/^[0-9]{3,4}$/] $server_git_repo_umask = $puppet::params::server_git_repo_umask,
String $server_git_repo_group = $puppet::params::server_git_repo_group,
String $server_git_repo_user = $puppet::params::server_git_repo_user,
Hash[String, String] $server_git_branch_map = $puppet::params::server_git_branch_map,
Integer[0] $server_idle_timeout = $puppet::params::server_idle_timeout,
String $server_post_hook_content = $puppet::params::server_post_hook_content,
String $server_post_hook_name = $puppet::params::server_post_hook_name,
Boolean $server_storeconfigs = $puppet::params::server_storeconfigs,
Array[Stdlib::Absolutepath] $server_ruby_load_paths = $puppet::params::server_ruby_load_paths,
Stdlib::Absolutepath $server_ssl_dir = $puppet::params::server_ssl_dir,
Boolean $server_ssl_dir_manage = $puppet::params::server_ssl_dir_manage,
Boolean $server_ssl_key_manage = $puppet::params::server_ssl_key_manage,
Array[String] $server_ssl_protocols = $puppet::params::server_ssl_protocols,
Optional[Stdlib::Absolutepath] $server_ssl_chain_filepath = $puppet::params::server_ssl_chain_filepath,
Optional[Variant[String, Array[String]]] $server_package = $puppet::params::server_package,
Optional[String] $server_version = $puppet::params::server_version,
String $server_certname = $puppet::params::server_certname,
Integer[0] $server_request_timeout = $puppet::params::server_request_timeout,
Boolean $server_strict_variables = $puppet::params::server_strict_variables,
Hash[String, Data] $server_additional_settings = $puppet::params::server_additional_settings,
Boolean $server_foreman = $puppet::params::server_foreman,
Optional[Stdlib::HTTPUrl] $server_foreman_url = $puppet::params::server_foreman_url,
Optional[Stdlib::Absolutepath] $server_foreman_ssl_ca = $puppet::params::server_foreman_ssl_ca,
Optional[Stdlib::Absolutepath] $server_foreman_ssl_cert = $puppet::params::server_foreman_ssl_cert,
Optional[Stdlib::Absolutepath] $server_foreman_ssl_key = $puppet::params::server_foreman_ssl_key,
Boolean $server_foreman_facts = $puppet::params::server_foreman_facts,
Optional[Stdlib::Absolutepath] $server_puppet_basedir = $puppet::params::server_puppet_basedir,
Enum['current', 'future'] $server_parser = $puppet::params::server_parser,
Variant[Undef, Enum['unlimited'], Pattern[/^\d+[smhdy]?$/]] $server_environment_timeout = $puppet::params::server_environment_timeout,
String $server_jvm_java_bin = $puppet::params::server_jvm_java_bin,
String $server_jvm_config = $puppet::params::server_jvm_config,
Pattern[/^[0-9]+[kKmMgG]$/] $server_jvm_min_heap_size = $puppet::params::server_jvm_min_heap_size,
Pattern[/^[0-9]+[kKmMgG]$/] $server_jvm_max_heap_size = $puppet::params::server_jvm_max_heap_size,
Optional[Variant[String,Array[String]]] $server_jvm_extra_args = $puppet::params::server_jvm_extra_args,
Optional[String] $server_jvm_cli_args = $puppet::params::server_jvm_cli_args,
Optional[Stdlib::Absolutepath] $server_jruby_gem_home = $puppet::params::server_jruby_gem_home,
Hash[String, String] $server_environment_vars = $puppet::params::server_environment_vars,
Integer[1] $server_max_active_instances = $puppet::params::server_max_active_instances,
Integer[0] $server_max_requests_per_instance = $puppet::params::server_max_requests_per_instance,
Integer[0] $server_max_queued_requests = $puppet::params::server_max_queued_requests,
Integer[0] $server_max_retry_delay = $puppet::params::server_max_retry_delay,
Boolean $server_multithreaded = $puppet::params::server_multithreaded,
Boolean $server_check_for_updates = $puppet::params::server_check_for_updates,
Boolean $server_environment_class_cache_enabled = $puppet::params::server_environment_class_cache_enabled,
Boolean $server_allow_header_cert_info = $puppet::params::server_allow_header_cert_info,
Integer[0] $server_web_idle_timeout = $puppet::params::server_web_idle_timeout,
Boolean $server_puppetserver_metrics = true,
Boolean $server_puppetserver_profiler = true,
Optional[Boolean] $server_puppetserver_telemetry = undef,
Boolean $server_metrics_jmx_enable = $puppet::params::server_metrics_jmx_enable,
Boolean $server_metrics_graphite_enable = $puppet::params::server_metrics_graphite_enable,
String $server_metrics_graphite_host = $puppet::params::server_metrics_graphite_host,
Integer $server_metrics_graphite_port = $puppet::params::server_metrics_graphite_port,
String $server_metrics_server_id = $puppet::params::server_metrics_server_id,
Integer $server_metrics_graphite_interval = $puppet::params::server_metrics_graphite_interval,
Optional[Array] $server_metrics_allowed = $puppet::params::server_metrics_allowed,
Boolean $server_puppetserver_experimental = $puppet::params::server_puppetserver_experimental,
Optional[String[1]] $server_puppetserver_auth_template = $puppet::params::server_puppetserver_auth_template,
Array[String] $server_puppetserver_trusted_agents = $puppet::params::server_puppetserver_trusted_agents,
Array[Hash] $server_puppetserver_trusted_certificate_extensions = $puppet::params::server_puppetserver_trusted_certificate_extensions,
Optional[Enum['off', 'jit', 'force']] $server_compile_mode = $puppet::params::server_compile_mode,
Optional[Integer[1]] $server_acceptor_threads = undef,
Optional[Integer[1]] $server_selector_threads = undef,
Optional[Integer[1]] $server_ssl_acceptor_threads = undef,
Optional[Integer[1]] $server_ssl_selector_threads = undef,
Optional[Integer[1]] $server_max_threads = undef,
Boolean $server_ca_allow_sans = $puppet::params::server_ca_allow_sans,
Boolean $server_ca_allow_auth_extensions = $puppet::params::server_ca_allow_auth_extensions,
Boolean $server_ca_enable_infra_crl = $puppet::params::server_ca_enable_infra_crl,
Optional[Integer[1]] $server_max_open_files = $puppet::params::server_max_open_files,
Optional[Stdlib::Absolutepath] $server_versioned_code_id = undef,
Optional[Stdlib::Absolutepath] $server_versioned_code_content = undef,
Array[String[1]] $server_jolokia_metrics_allowlist = [],
Stdlib::Filemode $puppetconf_mode = $puppet::params::puppetconf_mode,
) inherits puppet::params {
contain puppet::config
if $agent == true {
contain puppet::agent
}
if $server == true {
contain puppet::server
}
# Ensure the server is running before the agent needs it, and that
# certificates are generated in the server config (if enabled)
if $server == true and $agent == true {
Class['puppet::server'] -> Class['puppet::agent::service']
}
}
|
