Ceph Puppet Module
Go to file
Carlos Camacho e72b6f34d2 Fix lint issues to upgrade to puppet-lint 2.3
2017-07-20 14:28:44.376006 | manifests/mon.pp:121:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376112 | manifests/mon.pp:157:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376146 | manifests/mon.pp:165:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376178 | manifests/mon.pp:203:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376209 | manifests/mon.pp:209:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376240 | manifests/mon.pp:230:WARNING: arrow should be on the right operand's line
2017-07-20 14:28:44.376286 | manifests/mon.pp:244:WARNING: arrow should be on the right operand's line

Change-Id: I2fe4ed016100ebda260dcfdc67d2907c7cc06787
2017-07-20 19:55:29 +02:00
examples Add cephfs resource type and profile 2017-01-10 14:48:12 +01:00
lib/puppet Set lowercase for ceph_config values 2017-06-12 14:57:05 -03:00
manifests Fix lint issues to upgrade to puppet-lint 2.3 2017-07-20 19:55:29 +02:00
releasenotes Fix openstackdocstheme 2017-07-02 14:09:58 +08:00
spec Fix tests for latest puppet 2017-07-07 14:18:37 -06:00
.gitignore Re-boostrap beaker tests 2016-07-07 16:27:14 -04:00
.gitreview Update .gitreview for new namespace 2015-11-05 17:15:13 -05:00
bindep.txt Update tox configuration 2017-05-18 18:06:56 +02:00
Gemfile Update tox configuration 2017-05-18 18:06:56 +02:00
LICENSE Add project files 2013-10-20 22:45:54 -07:00
metadata.json Prepare for 2.3.0 2017-02-08 08:16:25 -07:00
Rakefile Re-boostrap beaker tests 2016-07-07 16:27:14 -04:00
README.md Update URLs in documents according to document migration 2017-07-14 08:50:53 +08:00
setup.cfg Merge "Update URLs in documents according to document migration" 2017-07-18 19:20:40 +00:00
setup.py Prepare puppet-ceph for 1.0.0 2016-05-06 17:54:13 -04:00
test-requirements.txt Fix openstackdocstheme 2017-07-02 14:09:58 +08:00
tox.ini Add environment variable 2017-06-12 15:48:06 +08:00
USECASES.md Remove Puppetfile in favor of metadata.json 2016-04-12 14:34:29 +00:00

Team and repository tags

Team and repository tags

ceph

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 restults
  9. Contributors - Those with commits
  10. Release Notes - Notes on the most recent updates to the module

Overview

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.

Setup

Implementation

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

Limitations

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

Development

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

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

Contributors

Release Notes