Skip to content

Latest commit

 

History

History
114 lines (79 loc) · 2.64 KB

README.md

File metadata and controls

114 lines (79 loc) · 2.64 KB
Raw

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