{"id":15227825,"url":"https://github.com/voxpupuli/puppet-jolokia","last_synced_at":"2025-04-10T00:42:57.838Z","repository":{"id":45398206,"uuid":"56705115","full_name":"voxpupuli/puppet-jolokia","owner":"voxpupuli","description":"Install jolokia agents, and configure","archived":false,"fork":false,"pushed_at":"2025-03-19T20:17:40.000Z","size":208,"stargazers_count":5,"open_issues_count":2,"forks_count":4,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-04-10T00:42:34.786Z","etag":null,"topics":["hacktoberfest","linux-puppet-module","puppet","redhat-puppet-module"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxpupuli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2016-04-20T17:01:30.000Z","updated_at":"2025-03-19T20:17:42.000Z","dependencies_parsed_at":"2023-11-26T07:31:02.030Z","dependency_job_id":"68e99ea7-7a90-4878-9d8f-bd9347bf3442","html_url":"https://github.com/voxpupuli/puppet-jolokia","commit_stats":{"total_commits":110,"total_committers":11,"mean_commits":10.0,"dds":"0.19090909090909092","last_synced_commit":"c6b84d812ffa8d9a5a17fab87d49ae28b0f5a38b"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-jolokia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-jolokia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-jolokia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-jolokia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-jolokia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137998,"owners_count":21053775,"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":["hacktoberfest","linux-puppet-module","puppet","redhat-puppet-module"],"created_at":"2024-09-28T23:06:11.618Z","updated_at":"2025-04-10T00:42:57.810Z","avatar_url":"https://github.com/voxpupuli.png","language":"Ruby","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":[],"sub_categories":[],"readme":"#### Table of Contents\n\n1. [Overview](#overview)\n3. [Setup Requirements](#setup-requirements)\n4. [Usage - Configuration options and additional functionality](#usage)\n5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Overview\n\nThis Puppet 5.+ module installs and helps configure\n[jolokia](https://jolokia.org/) (jvm) agents.\n\n\n### Setup Requirements\n\nCurrently, this module expects you to provide a package for your platform which\nit then installs. We generally *highly* recommend this approach, because it\nmakes life easier.\n\n### Usage\n\n```puppet\ninclude jolokia\n```\n\nAfter this statement you should be able to extend your JVMs' `JAVA_OPTS` with\n\n```\n-javaagent:/usr/lib/java/jolokia-jvm-agent.jar=host=0.0.0.0\n```\n\nMore more complex configurations can be put into a properties file. We provide\na wrapper for that:\n\n```puppet\n$props = {\n  'host' =\u003e '*',\n  'policyLocation' =\u003e 'file:///etc/jolokia/lolsecurity.xml',\n}\n\njolokia::config { 'puppetserver':\n  properties =\u003e $props + { 'port' =\u003e '7887' }\n}\njolokia::config { 'puppetdb':\n  properties =\u003e $props + { 'port' =\u003e '7889' }\n}\n```\n\nWe also provide a wrapper for creating policy files. However, currently it's\nrestricted host-based authorization only:\n\n```puppet\njolokia::policy { 'lolsecurity':\n  allowed_hosts =\u003e [ '1.1.1.1', '::1' ]\n}\n```\n\n## Reference\n\n### jolokia\n\nThis class is the main driver for the installation.\n\n```puppet\n  String $jvm_agent_ensure = 'present',\n  String $jvm_agent_name   = 'jolokia-jvm-agent',\n  String $config_dir       = '/etc/jolokia',\n```\n\n### jolokia::config\n\nThis define allows creating arbitrary properties files for each application.\n\n```puppet\n  String                 $app        = $title,\n  Enum['file', 'absent'] $ensure     = 'file',\n  Hash                   $properties = {},\n```\n\n### jolokia::policy\n\nThis define allows policy files for *host-based* *authorization* Usually one\nper host should suffice, unless you require distinct *authentication*.\n\n```puppet\n  String                 $app           = $title,\n  Enum['file', 'absent'] $ensure        = 'file',\n  Array[String]          $allowed_hosts = ['127.0.0.1', '::1'],\n```\n\n## Limitations\n\n* currently we expect you to provide your own package(s)\n* policy configuration only creates host-based authorization\n* our documentation is sad\n\n##Development\n\n### Running tests\n\nThis project contains tests for [rspec-puppet](http://rspec-puppet.com/).\n\nQuickstart:\n\n```bash\ngem install bundler\nbundle install --path .vendor/\nbundle exec rake test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-jolokia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-jolokia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-jolokia/lists"}