Skip to content
Ceph Puppet Module
Branch: master
Clone or download
OpenDev Sysadmins
OpenDev Sysadmins OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at with any
questions you may have.
Latest commit 4d96efd Apr 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/puppet Set lowercase for ceph_config values Jun 12, 2017
manifests Change default version to Ceph Nautilus Apr 4, 2019
releasenotes Update master for stable/mimic Mar 25, 2019
spec Change default version to Ceph Nautilus Apr 4, 2019
.zuul.yaml switch documentation job to new PTI Aug 31, 2018
Gemfile Load puppet-openstack_spec_helper locally during tests Feb 12, 2018
LICENSE Add project files Oct 21, 2013 Supply hrefs for table of contents according to context Dec 5, 2018
Rakefile Re-boostrap beaker tests Jul 7, 2016
bindep.txt Add Puppet package to bindep, for module build Oct 30, 2017
metadata.json Release 2.6.0 Mar 21, 2019
setup.cfg Prepare puppet-ceph for 1.0.0 May 6, 2016
tox.ini Update min tox version to 2.0 Oct 16, 2018

Team and repository tags

Team and repository tags


Table of Contents

  1. Overview - What is the ceph module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with ceph
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Use Cases - Examples of how to use this module
  7. Development - Guide for contributing to the module
  8. Beaker Integration Tests - Apply the module and test results
  9. Contributors - Those with commits
  10. Release Notes - Notes on the most recent updates to the module
  11. Repository - Repository for the module


The ceph module is intended to leverage all Ceph has to offer and allow for a wide range of use case. Although hosted on the OpenStack infrastructure, it does not require to sign a CLA nor is it restricted to OpenStack users. It benefits from a structured development process that helps federate the development effort. Each feature is tested with integration tests involving virtual machines to show that it performs as expected when used with a realistic scenario.

Module Description

The ceph module deploys a Ceph cluster ( MON, OSD ), the Cephfs file system and the RadosGW object store. It provides integration with various environments ( OpenStack ... ) and components to be used by third party puppet modules that depend on a Ceph cluster.



A blueprint contains an inventory of what is desirable. It was decided to start from scratch and implement one module at a time.


We follow the OS compatibility of Ceph. With the release of infernalis this is currently:

  • CentOS 7 or later
  • Debian Jessie 8.x or later
  • Ubuntu Trusty 14.04 or later
  • Fedora 22 or later

Use Cases


git clone
cd puppet-ceph
sudo gem install bundler
bundle install

The developer documentation of the puppet-openstack project is the reference:

Mailing lists:

IRC channels:


Beaker Integration Tests

Relies on rspec-beaker and tests are in spec/acceptance. It also requires Vagrant and Virtualbox .

bundle install
bundle exec rspec spec/acceptance

The BEAKER_set environment variable contains the resource set of linux distribution configurations for which integration tests are going to be run. Available values are

  • two-centos-70-x64
  • centos-70-x64
  • two-ubuntu-server-1404-x64
  • ubuntu-server-1404-x64

The default is

BEAKER_set=two-ubuntu-server-1404-x64 \
bundle exec rspec spec/acceptance


Developer documentation for the entire puppet-openstack project.


Release Notes


You can’t perform that action at this time.