f08e9ea165
* Consistent email across cookbooks * Add Contributor.md to help out new folks * Fix file modes * Fix broken link in Testing.md * Readme tweaks Change-Id: I1c12cc86e8d51701e885673947547fae50e003a2 Partial-Bug: #1342735
130 lines
2.5 KiB
Markdown
130 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
|
|
* yum
|
|
* yum-epel
|
|
|
|
|
|
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.
|