28642f9cdc
Because there is not #integration-tests paragraph, so https://github.com/stackforge/puppet-ceph#integration-tests is invalid. I change the paragraph title 'Integration' to 'Integration Test', the link will be ok. Change-Id: Ic7bc02e6458e2dd2a81635b92306c56bcd3fa96a |
||
---|---|---|
lib/puppet | ||
manifests | ||
spec | ||
.fixtures.yml | ||
.gitignore | ||
.gitreview | ||
.nodeset.yml | ||
Gemfile | ||
LICENSE | ||
Modulefile | ||
Puppetfile | ||
README.md | ||
Rakefile |
README.md
ceph
Table of Contents
- Overview - What is the ceph module?
- Module Description - What does the module do?
- Setup - The basics of getting started with ceph
- Implementation - An under-the-hood peek at what the module is doing
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- Contributors - Those with commits
- Integration - Apply the module and test restults
- 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 component is unit tested and an integration test shows 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
Development
git clone https://github.com/stackforge/puppet-ceph.git
cd puppet-ceph
# nokogiri dependencies
sudo apt-get install ruby-dev libxml2-dev libxslt-dev
sudo gem install bundler
bundle install
The developer documentation of the puppet-openstack project is the reference:
Mailing lists:
- (puppet-openstack)[https://groups.google.com/a/puppetlabs.com/forum/#!forum/puppet-openstack]
- (ceph-devel)[http://ceph.com/resources/mailing-list-irc/]
IRC channels:
- irc.freenode.net#puppet-openstack
- irc.oftc.net#ceph-devel
Integration Tests
Relies on rspec-system-puppet and tests are in spec/system. It runs virtual machines and requires 4GB of free memory and 10GB of free disk space.
-
bundle install --path vendor/bundle
-
bundle exec rake spec:system
On success it should complete with
...
=end=============================================================
Finished in 4 minutes 1.7 seconds
1 example, 0 failures