Skip to content
master
Switch branches/tags
Go to file
Code
This branch is 57 commits ahead, 257 commits behind openstack:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 results
  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. This module was originally forked from the openstack/puppet-ceph module and since changed to support uses cases required by our project. Additional functionality was also added to support more Ceph services. It has diverged sufficiently that a clean merge from the origin repository is likely to be difficiult. At some point an evaluation of this module compared to the current state of the openstack origin may be in order to identify commits worth merging or pull-requests that could be fed back.

Some links to documentation are left as-is from the original as they may still be relevant. Parts relevant to using the module are updated with current usage.

Summary of added features or changes:

  • Supports multiple cluster configs on same host changing ceph::cluster class to resource.
  • Change ceph::rgw class to resource allowing management of multiple instances on same host
  • Modify other classes as needed to specify cluster name
  • Added additional params to ceph_cluster such as osd_crush_location, debugging control, etc (see manifest)
  • Turn ceph::mds class into resource, add service/directory management.
  • Add REST API resource ceph::restapi
  • Add ceph-mgr resource ceph::mgr
  • Modify ceph::osd to support bluestore and create logical volumes for data and block.db devices
  • Removed filestore support

Module Description

The ceph module deploys a Ceph cluster ( MON, OSD , MGR), the Cephfs file system and the RadosGW object store. It provides integration with various environments 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/MI-OSiRIS/puppet-ceph
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

About

Ceph Puppet Module

Resources

License

Releases

No releases published

Packages

No packages published