Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

115 lines (79 sloc) 2.702 kb

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
    
Jump to Line
Something went wrong with that request. Please try again.