{"id":27958129,"url":"https://github.com/ericsson/puppet-module-puppetserver","last_synced_at":"2025-05-07T18:16:31.206Z","repository":{"id":42524313,"uuid":"64648905","full_name":"Ericsson/puppet-module-puppetserver","owner":"Ericsson","description":null,"archived":false,"fork":false,"pushed_at":"2022-10-18T14:56:01.000Z","size":55,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-07T18:16:26.443Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ericsson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-01T08:15:47.000Z","updated_at":"2024-03-25T13:20:51.000Z","dependencies_parsed_at":"2023-01-20T01:47:18.501Z","dependency_job_id":null,"html_url":"https://github.com/Ericsson/puppet-module-puppetserver","commit_stats":null,"previous_names":["ericsson/puppet-module-puppetserver"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-puppetserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-puppetserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-puppetserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-puppetserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ericsson","download_url":"https://codeload.github.com/Ericsson/puppet-module-puppetserver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252931508,"owners_count":21827112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T18:16:29.562Z","updated_at":"2025-05-07T18:16:30.791Z","avatar_url":"https://github.com/Ericsson.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# puppetserver\n\n## Overview\n\nPuppet module to manage Puppet Server\n\n### Dependencies\n\n* [puppetlabs-stdlib](https://forge.puppetlabs.com/puppetlabs/stdlib) (\u003e= 4.6.0)\n* [puppetlabs-inifile](https://forge.puppetlabs.com/puppetlabs/inifile) (\u003e= 1.1.0)\n* [puppetlabs-hocon](https://forge.puppetlabs.com/puppetlabs/hocon) (\u003e= 0.9.0 \u003c 1.0.0)\n\n## Usage\n\nManage puppetserver with default settings\n\n    include puppetserver\n\n### Example configuration\n\n    class { puppetserver:\n      enable_ca =\u003e false,\n      java_args =\u003e {\n        '-Xms' =\u003e { 'value' =\u003e '2g' },\n        '-Xmx' =\u003e { 'value' =\u003e '4g' }\n      },\n    }\n\n### Hiera Example\n\n    puppetserver::enable_ca: false\n\n    puppetserver::java_args:\n      '-Xmx':\n        value: '4g'\n      '-XX:MaxPermSize=':\n        value: '512m'\n\n    puppetserver::puppetserver_settings:\n      'jruby-puppet.max-active-instances':\n        value: 6\n      'profiler.enabled':\n        value: true\n      'puppet-admin.client-whitelitst':\n        type: 'array'\n        value:\n          - 'host1.domain.tld'\n\n    puppetserver::webserver_settings:\n      'webserver.ssl-port':\n        type: 'number'\n        value: 9140\n\n\n## Reference\n\n### Class: puppetserver\n\nClass to install package and manage puppetserver service. Configuration is done by `puppetserver::config`.\n\n#### `enable_ca`\nBoolean to control if the CA service should be enabled.\n\nDefault: `true`\n\n#### `package_ensure`\nEnsure attribute for the package\n\nDefault: `'installed'`\n\n#### `package_name`\nName of the package(s) to manage\n\nDefault: `'puppetserver'`\n\n#### `service_enable`\nEnable attribute for the service\n\nDefault: `true`\n\n#### `service_ensure`\nEnsure attribute for the service\n\nDefault: `'running'`\n\n#### `java_args`\nHash with Java arguments to set for puppetserver. `puppetserver::config::java_arg` resources are created from hash.\n\nDefault: `undef`\n\n#### `bootstrap_settings`\nHash with `file_line` resources for configuring lines in bootstrap.cfg\n\nDefault: `undef`\n\n#### `bootstrap_settings_hiera_merge`\nBoolean to trigger merging hashes for `bootstrap_settings` through all hiera levels.\n\nDefault: `false`\n\n#### `puppetserver_settings`\nHash with HOCON style settings for puppetserver.conf. `puppetserver::config::hocon` resources are created from hash.\n\nDefault: `undef`\n\n#### `puppetserver_settings_hiera_merge`\nBoolean to trigger merging hashes for `puppetserver_settings` through all hiera levels.\n\nDefault: `false`\n\n#### `webserver_settings`\nHash with HOCON style settings for webserver.conf. `puppetserver::config::hocon` resources are created from hash.\n\nDefault: `undef`\n\n#### `webserver_settings_hiera_merge`\nBoolean to trigger merging hashes for `webserver_settings` through all hiera levels.\n\nDefault: `false`\n\n\n### Class: puppetserver::config\n\nInternal class to do puppetserver configuration.\n\n#### `bootstrap_cfg`\nString to specify the path and filename to the bootstrapping configuration file. The default value is valid for puppetserver \u003e= 2.5.0.\n\nDefault: `/etc/puppetlabs/puppetserver/services.d/ca.cfg`\n\n#### `configdir`\nString to specify the path to puppetservers configuration files and settings directory. The default value is valid for puppetserver \u003e= 2.5.0.\n\nDefault: `/etc/puppetlabs/puppetserver/conf.d`\n\n#### `enable_ca`\nBoolean to control if the CA service should be enabled.\n\nDefault: `$::puppetserver::enable_ca`\n\n#### `enable_tmpfix`\nBoolean to control if the workaround for /tmp being mounted with noexec should get applied.\nWhen active /var/lib/puppet/tmp will be created and used as temporary directory for puppetserver.\nThis implements the workaround described here: https://gist.github.com/csschwe/cbdd36e27ee708aba441#gistcomment-1336281\n\nDefault: `true`\n\n#### `java_args`\nHash with Java arguments to set for puppetserver. `puppetserver::config::java_arg` resources are created from hash.\n\nDefault: `$::puppetserver::java_args`\n\n#### `bootstrap_settings`\nHash with `file_line` resources for configuring lines in bootstrap.cfg\n\nDefault: `$::puppetserver::bootstrap_settings`\n\n#### `puppetserver_settings`\nHash with HOCON style settings for puppetserver.conf. `puppetserver::config::hocon` resources are created from hash.\n\nDefault: `$::puppetserver::puppetserver_settings`\n\n#### `webserver_settings`\nHash with HOCON style settings for webserver.conf. `puppetserver::config::hocon` resources are created from hash.\n\nDefault: `$::puppetserver::webserver_settings`\n\n\n### Resource: puppetserver::config::java_arg\n\nWrapper to manage JAVA_ARGS in puppetserver sysconfig. Uses `ini_subsetting` from `puppetlabs-inifile`.\n\n#### `namevar`\nName of the setting to change.\n\n#### `ensure`\nSet to `absent` to remove a setting\n\nDefault: `present`\n\n#### `value`\nValue for the setting.\n\n\n### Resource: puppetserver::config::hocon\n\nWrapper to create `hocon_setting` resources from `puppetlabs-hocon`.\n\n#### `ensure`\nEnsures that the resource is present. Valid values are 'present', 'absent'.\n\nDefault: `present`\n\n#### `path`\nThe HOCON file in which Puppet will ensure the specified setting.\n\n#### `setting` (namevar)\nThe name of the HOCON file setting to be defined.\n\n#### `type`\nThe type of the value passed into the value parameter. This value should be a string, with valid values being 'number', 'boolean', 'string', 'hash', 'array', 'array_element', and 'text'.\n\n\n## Limitations\n\nModule is tested using Puppet 3.8.x and Puppetserver 1.x on el7.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsson%2Fpuppet-module-puppetserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericsson%2Fpuppet-module-puppetserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsson%2Fpuppet-module-puppetserver/lists"}