ceph/doc/config-cluster/chef.rst
John Wilkins ff64818f1c doc/config-cluster/chef.rst <-fixed an error in upload command.
doc/config-cluster/deploying-ceph-conf.rst <-added sudo. required.
doc/config-cluster/deploying-ceph-with-mkcephfs.rst <-cd to /etc/ceph so keyring goes there.
doc/install/chef.rst <-added update and install opscode-keyring, and upgrade.
doc/install/debian.rst <-added ceph-common to the install

Signed-off-by: John Wilkins <john.wilkins@dreamhost.com>
2012-05-22 17:10:43 -07:00

91 lines
2.3 KiB
ReStructuredText

=====================
Deploying with Chef
=====================
We use Chef cookbooks to deploy Ceph. See `Managing Cookbooks with Knife`_ for details
on using ``knife``. For Chef installation instructions, see
`Installing Chef <../../install/chef>`_.
Add a Cookbook Path
-------------------
Add the ``cookbook_path`` to your ``~/.ceph/knife.rb`` configuration file. For example::
cookbook_path '/home/userId/.chef/ceph-cookbooks'
Install Ceph Cookbooks
----------------------
To get the cookbooks for Ceph, clone them from git.::
cd ~/.chef
git clone https://github.com/ceph/ceph-cookbooks.git
knife cookbook upload parted btrfs ceph
Install Apache Cookbooks
------------------------
RADOS Gateway uses Apache 2. So you must install the Apache 2 cookbooks.
To retrieve the Apache 2 cookbooks, execute the following::
cd ~/.chef/ceph-cookbooks
knife cookbook site download apache2
The `apache2-{version}.tar.gz`` archive will appear in your ``~/.ceph`` directory.
In the following example, replace ``{version}`` with the version of the Apache 2
cookbook archive knife retrieved. Then, expand the archive and upload it to the
Chef server.::
tar xvf apache2-{version}.tar.gz
knife cookbook upload apache2
Configure Chef
--------------
To configure Chef, you must specify an environment and a series of roles. You
may use the Web UI or ``knife`` to perform these tasks.
The following instructions demonstrate how to perform these tasks with ``knife``.
Create a role file for the Ceph monitor. ::
cat >ceph-mon.rb <<EOF
name "ceph-mon"
description "Ceph monitor server"
run_list(
'recipe[ceph::single_mon]'
)
EOF
Create a role file for the OSDs. ::
cat >ceph-osd.rb <<EOF
name "ceph-osd"
description "Ceph object store"
run_list(
'recipe[ceph::bootstrap_osd]'
)
EOF
Add the roles to Chef using ``knife``. ::
knife role from file ceph-mon.rb ceph-osd.rb
You may also perform the same tasks with the command line and a ``vim`` editor.
Set an ``EDITOR`` environment variable. ::
export EDITOR=vi
Then exectute::
knife create role {rolename}
The ``vim`` editor opens with a JSON object, and you may edit the settings and
save the JSON file.
Finally configure the nodes. ::
knife node edit {nodename}
.. _Managing Cookbooks with Knife: http://wiki.opscode.com/display/chef/Managing+Cookbooks+With+Knife