cookbook-ceph/README.md
Alexandre Marangone 1d30cf43e6 Update README.md
Signed-off-by: Alexandre Marangone <alexandre.marangone@inktank.com>
2013-03-20 13:12:52 -07:00

128 lines
2.5 KiB
Markdown

Chef cookbook for deploying the Ceph storage system
===================================================
Note: "knife cookbook upload" needs this directory to be named "ceph".
Please clone the repository as
git clone https://github.com/ceph/ceph-cookbooks.git ceph
(we cannot name this repository ceph.git, as that is the main project
itself)
DESCRIPTION
===========
Installs and configures Ceph, a distributed network storage and filesystem designed to provide excellent performance, reliability, and scalability.
The current version is focused towards deploying Monitors and OSD on Ubuntu.
For documentation on how to use this cookbook, refer to the [USAGE](#USAGE) section.
Work in progress:
* RadosGW
* MDS
* Other Distro (Debian, RHEL/CentOS, FC)
REQUIREMENTS
============
Platform
--------
Tested as working:
* Ubuntu Precise (12.04)
Cookbooks
---------
The ceph cookbook requires the following cookbooks from Opscode:
https://github.com/opscode/cookbooks
* apt
* apache2
ATTRIBUTES
==========
Ceph Rados Gateway
------------------
* node[:ceph][:radosgw][:api_fqdn]
* node[:ceph][:radosgw][:admin_email]
* node[:ceph][:radosgw][:rgw_addr]
TEMPLATES
=========
USAGE
=====
Ceph cluster design is beyond the scope of this README, please turn to the
public wiki, mailing lists, visit our IRC channel, or contact Inktank:
http://ceph.com/docs/master
http://ceph.com/resources/mailing-list-irc/
http://www.inktank.com/
Ceph Monitor
------------
Ceph monitor nodes should use the ceph-mon role.
Includes:
* ceph::default
* ceph::conf
Ceph Metadata Server
--------------------
Ceph metadata server nodes should use the ceph-mds role.
Includes:
* ceph::default
Ceph OSD
--------
Ceph OSD nodes should use the ceph-osd role
Includes:
* ceph::default
* ceph::conf
Ceph Rados Gateway
------------------
Ceph Rados Gateway nodes should use the ceph-radosgw role
LICENSE AND AUTHORS
===================
* Author: Kyle Bader <kyle.bader@dreamhost.com>
* Copyright 2013, DreamHost Web Hosting and Inktank Storage Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.