Ceph Puppet Module
Go to file
Zuul f2b3516b7f Merge "RGW: Add warning about civetweb and fastcgi" 2023-09-11 03:38:23 +00:00
doc Update openstackdocstheme to the latest version 2021-09-29 16:06:50 +08:00
examples Change default version to Ceph Nautilus 2019-04-04 14:40:37 +02:00
lib/puppet Hide credential strings from puppet logs 2021-11-29 13:16:58 +00:00
manifests Merge "RGW: Add warning about civetweb and fastcgi" 2023-09-11 03:38:23 +00:00
releasenotes Merge "RGW: Add warning about civetweb and fastcgi" 2023-09-11 03:38:23 +00:00
spec Merge "Remove support for CentOS 8 (non-stream)" 2023-09-11 02:30:14 +00:00
.gitignore Dissuade .gitignore references to personal tools 2018-10-08 11:39:23 +08:00
.gitreview OpenDev Migration Patch 2019-04-19 19:31:41 +00:00
.pdkignore Exclude release note files 2023-08-11 17:48:16 +09:00
.zuul.yaml Remove CentOS/RHEL 7 support 2023-09-07 02:19:44 +09:00
CONTRIBUTING.rst [ussuri][goal] Add CONTRIBUTING.rst 2020-05-10 22:32:11 +02:00
Gemfile Use openstack_spec_helper from zuul checkout 2020-08-30 22:53:44 +02:00
LICENSE Add project files 2013-10-20 22:45:54 -07:00
README.md Update IRC network to OFTC 2021-05-31 15:38:29 +00:00
Rakefile Re-boostrap beaker tests 2016-07-07 16:27:14 -04:00
USECASES.md Replace legacy facts and use fact hash 2023-03-06 16:38:13 +09:00
bindep.txt Add Puppet package to bindep, for module build 2017-10-30 23:50:26 +00:00
metadata.json Remove support for Puppet 5 and Ubuntu 18.04 2023-09-06 17:20:13 +00:00
setup.cfg Add information technology in the setup.cfg 2021-10-01 06:54:49 +08:00
setup.py setuptools: Disable auto discovery 2022-03-29 19:01:30 +09:00
tox.ini Stop configuring install_command in tox. 2021-09-29 18:04:32 +09:00


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.oftc.net#puppet-openstack
  • irc.oftc.net#ceph-devel


Developer documentation for the entire puppet-openstack project.


Release Notes