Ceph Puppet Module
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Takashi Kajinami 30bb45cc10 Add Ubuntu Focal to the supporrted operating systesm 8 months ago
doc Switch to newer openstackdocstheme and reno versions 2 years ago
examples Change default version to Ceph Nautilus 3 years ago
lib/puppet Set lowercase for ceph_config values 5 years ago
manifests Fix CentOS Storage SIG mirror URL 2 years ago
releasenotes Set openstackdocs_auto_name to use 'project' as name 1 year ago
spec Remove beaker 1 year ago
.gitignore Dissuade .gitignore references to personal tools 3 years ago
.gitreview OpenDev Migration Patch 3 years ago
.zuul.yaml Make p-o-i jobs voting again for puppet-ceph 3 years ago
CONTRIBUTING.rst [ussuri][goal] Add CONTRIBUTING.rst 2 years ago
Gemfile Use openstack_spec_helper from zuul checkout 1 year ago
LICENSE Add project files 8 years ago
README.md Remove beaker 1 year ago
Rakefile Re-boostrap beaker tests 5 years ago
USECASES.md Remove Puppetfile in favor of metadata.json 6 years ago
bindep.txt Add Puppet package to bindep, for module build 4 years ago
metadata.json Add Ubuntu Focal to the supporrted operating systesm 8 months ago
setup.cfg Change openstack-dev to openstack-discuss 3 years ago
setup.py Prepare puppet-ceph for 1.0.0 6 years ago
tox.ini Replace deprecated UPPER_CONSTRAINTS_FILE variable 1 year ago


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. Contributors - Those with commits
  9. Release Notes - Notes on the most recent updates to the module
  10. 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 https://github.com/openstack/puppet-ceph.git
cd puppet-ceph
sudo gem install bundler
bundle install

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

Mailing lists:

IRC channels:

  • irc.freenode.net#puppet-openstack
  • irc.oftc.net#ceph-devel


Developer documentation for the entire puppet-openstack project.


Release Notes