Puppet module for installing and managing remote bamboo agents

KnuEdge IT



5,396 latest version

4.3 quality score

Version information

  • 0.1.7 (latest)
  • 0.1.6
  • 0.1.5
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.0.2
released Nov 8th 2017
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0 < 5.0.0
  • Ubuntu

Start using this module


knuedge/bamboo_agent — version 0.1.7 Nov 8th 2017


Build Status

Build Status

Table of Contents

  1. Description
  2. Setup - The basics of getting started with bamboo_agent
  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


This module installs and manages remote bamboo agents. It supports multiple agents and can manage the capabilities and wrapper.conf files.


What bamboo_agent affects OPTIONAL

If it's obvious what your module touches, you can skip this section. For example, folks can probably figure out that your mysql_instance module affects their MySQL instances.

If there's more that they should know about, though, this is the place to mention:

  • A list of files, packages, services, or operations that the module will alter, impact, or execute.
  • Dependencies that your module automatically installs.
  • Warnings or other important notices.


The bamboo_agent class accepts a single parameter, agents, containing a hash of values that map directly onto the bamboo_agent::agent defined type. This example will create 2 bamboo agents, with custom capabilities and the wrapper.conf file managed for the first agent.

class { 'bamboo_agent':
  agents => {
    'bamboo-agent' => {
      home         => '/var/lib/bamboo-agent',
      server_url   => '',
      capabilities => {
        'system.builder.command.Bash' => '/bin/bash',
        'hostname'                    => $::hostname,
      'wrapper_conf_properties' => {
        '' => '-Djsse.enableSNIExtension=false',
        '' => '-Dbamboo.agent.ignoreServerCertName=TRUE'
    'bamboo-agent2' => {
      java_home  => '/etc/alternatives/jre_1.8.0',
      home       => '/var/lib/bamboo-agent2',
      server_url => '',

To use hiera

include bamboo_agent
    home: '/home/bamboo-agent'
      - 'rvm'
    server_url: ''
      hostname: "%{::hostname}"
      os: "%{::operatingsystem}"
    wrapper_conf_properties: '-Dbamboo.agent.ignoreServerCertName=true' '-Djsse.enableSNIExtension=false'


Class bamboo_agent

The main class.


  • agents: Accepts a hash. See the bamboo_agent::agent defined type for accepted parameters

Defined Typebamboo_agent::agent


  • home: requried The home directory of the bamboo-agent user
    • Default: unset
  • server_url: required The bamboo server url
    • Default: unset
  • capabilities: optional Hash of custom capabilites
    • Default: {}
  • manage_user: optionl Whether the module should create the user account
    • Default: true
  • manage_groups: optional Whether the module should create groups specified in `$user_groups*``
    • Default: false
  • manage_home: optional Whether the module should create the users home directory
    • Default: true
  • username: optional The username of the bamboo-agent user
    • Default: $title
  • user_groups: optional Groups bamboo-agent user should be a member of
  • manage_capabilities: optional Whether the module should manage the bamboo-agent's capabilities file
    • Default: true
  • wrapper_conf_properties: optoinal Options to be placed in the bamboo-agent's wrapper.conf file
    • Default: {}
  • service_name: optional Specify a unique name for the configured system service to be known as.
    • Default: $title
  • check_certificate: optional Whether to have wget check the certificate of the Bamboo server when downloading the installer jar
    • Default: true
  • java_home: optional Specify a value for the JAVA_HOME environment variable to include in the system init script.
    • Default: unset
  • uid: optional Specify a value for the bamboo agent's user ID.
    • Default: unset
  • gid: optional Specify a value for the bamboo agent's group ID.
    • Default: unset


This is where you list OS compatibility, version compatibility, etc. If there are Known Issues, you might want to include them under their own heading here.


  • Fork this module
  • Create a branch
  • Add tests for your changes
  • Submit a pull request