Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Puppet module for RabbitMQ on Ubuntu.
branch: master

This branch is even with garthk:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
manifests
tests
.gitignore
Makefile
Modulefile
README.md
Vagrantfile

README.md

Puppet module for RabbitMQ on Ubuntu.

Installation

cd /etc/puppet/modules
git clone git://github.com/garthk/puppet-rabbitmq rabbitmq

Usage

include rabbitmq

The class will:

  • Import RabbitMQ's signing key from keyserver.ubuntu.com
  • Add RabbitMQ's apt source to `/etc/apt/sources.list.d'
  • Perform apt-get update
  • Install RabbitMQ

VHosts

rabbitmq::vhost { 'logging':
  ensure => present,
}
  • ensure is optional, defaulting to present.
  • ensure => absent will remove the vhost.

Users

rabbitmq::user { 'admin':
  ensure   => present,
  password => "818f0d57",
  user_tag => administrator,
}

rabbitmq::user { 'guest':
  ensure => absent,
}
  • ensure is optional, defaulting to present.
  • password is mandatory if ensure => present.
  • user_tag is optional, defaulting to ""; useful values are administrator, monitoring, and management.

Permissions

rabbitmq::permissions { 'admin@logging':
  user  => 'admin',
  vhost => 'logging',
  conf  => '.*',
  write => '.*',
  read  => '.*',
}

rabbitmq::permissions { 'boris':
  ensure => absent,
  vhost => 'logging',
}
  • user is optional, defaulting to the $name (e.g. boris above)
  • ensure is optional, defaulting to present.
  • vhost is optional, defaulting to /.
  • ensure => absent strips all permissions on the vhost regardless of the other arguments.
  • conf, write, and read are optional, defaulting to ".*"

Plugins

rabbitmq::plugin { 'rabbitmq_management':
  enable => true,
}

rabbitmq::plugin { 'eldap':
  enable => false,
}
  • ensure is optional, defaulting to present.

CLI

class { 'rabbitmq::plugins::cli': 
  ensure => present,
}
  • ensure is optional, defaulting to present.
  • if ensure => present, you'll get /usr/sbin/rabbitmqadmin with command auto-completion on bash.
  • rabbitmq::plugin { 'rabbitmq_management': } is also required: otherwise, you'll get the CLI but nothing to talk to.

Testing:

Smoke Testing

  • make test or make smoke to perform a simple smoke test

Vagrant

  • Install Vagrant

  • Get the lucid32 box (safe even if you already have it):

    vagrant box add lucid32 http://files.vagrantup.com/lucid32.box
    
  • Launch the virtual machine:

    vagrant up
    
Something went wrong with that request. Please try again.