voxpupuli/puppet-jolokia

Name: puppet-jolokia

Owner: Vox Pupuli

Description: Install jolokia agents, and configure

Created: 2016-04-20 17:01:30.0

Updated: 2018-05-23 05:58:21.0

Pushed: 2018-05-23 05:58:19.0

Homepage: null

Size: 92

Language: Ruby

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Table of Contents

1. Overview
2. Setup Requirements
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Overview

This Puppet 4.+ module installs and helps configure jolokia (jvm) agents.

Setup Requirements

Currently, this module expects you to provide a package for your platform which it then installs. We generally highly recommend this approach, because it makes life easier.

Usage

ude ::jolokia

After this statement you should be able to extend your JVMs' JAVA_OPTS with

aagent:/usr/lib/java/jolokia-jvm-agent.jar=host=0.0.0.0

More more complex configurations can be put into a properties file. We provide a wrapper for that:

ps = {
ost' => '*',
olicyLocation' => 'file:///etc/jolokia/lolsecurity.xml',


kia::config { 'puppetserver':
operties => $props + { 'port' => '7887' }

kia::config { 'puppetdb':
operties => $props + { 'port' => '7889' }

We also provide a wrapper for creating policy files. However, currently it's restricted host-based authorization only:

kia::policy { 'lolsecurity':
lowed_hosts => [ '1.1.1.1', '::1' ]

Reference

jolokia

This class is the main driver for the installation.

ring $jvm_agent_ensure = 'present',
ring $jvm_agent_name   = 'jolokia-jvm-agent',
ring $config_dir       = '/etc/jolokia',

jolokia::config

This define allows creating arbitrary properties files for each application.

ring                 $app        = $title,
um['file', 'absent'] $ensure     = 'file',
sh                   $properties = {},

jolokia::policy

This define allows policy files for host-based authorization Usually one per host should suffice, unless you require distinct authentication.

ring                 $app           = $title,
um['file', 'absent'] $ensure        = 'file',
ray[String]          $allowed_hosts = ['127.0.0.1', '::1'],

Limitations

• currently we expect you to provide your own package(s)
• policy configuration only creates host-based authorization
• our documentation is sad

Development

Running tests

This project contains tests for rspec-puppet.

Quickstart:

install bundler
le install --path .vendor/
le exec rake test