Ceph 部署指南

本文档旨在详细说明如何安装和使用 Ceph cookbook，帮助用户理解和掌握 Ceph 集群的部署方法。

1. 安装指南

系统要求

• Chef 版本：≥ 11.6.0
• 操作系统：已测试在 Debian Wheezy (7)、Ubuntu Precise (12.04)、Ubuntu Trusty (14.04) 上工作
• 依赖的 Cookbooks：apt、apache2

安装步骤

1. 确保系统中已安装 Chef，并且版本符合要求。
2. 通过 Chef 的 supermarket 安装必要的 cookbooks：apt 和 apache2。
3. 设置 Ceph 集群所需的节点属性，如集群 UUID、网络配置等。

2. 项目使用说明

Ceph cookbook 可以用于部署 Monitor、OSD、Metadata Server 以及 Rados Gateway。以下是如何为不同角色配置节点的基本步骤：

• Ceph Monitor：使用 ceph-mon 角色，包括 ceph::default。
• Ceph Metadata Server：使用 ceph-mds 角色，包括 ceph::default。
• Ceph OSD：使用 ceph-osd 角色，包括 ceph::default。
• Ceph Rados Gateway：使用 ceph-radosgw 角色，包括 ceph::default。

使用策略封装Cookbook

建议使用策略封装Cookbook来自动化设置节点属性，例如自动检测硬盘并填充 node['ceph']['osd_devices']。

3. 项目API使用文档

Ceph cookbook 提供了以下自定义资源：

• ceph_client：用于创建 Ceph 客户端密钥。
• ceph_cephfs：用于挂载 CephFS。
• ceph_pool：用于创建和删除 Ceph 存储池。

每个资源的详细使用方法如下：

ceph_client

用于创建 Ceph 客户端密钥。

• Actions：:add
• Parameters：
  • :name：客户端密钥的名称。
  • :caps：授权给客户端的能力，默认为 { 'mon' => 'allow r', 'osd' => 'allow r' }。
  • :as_keyring：是否将密钥保存为 keyring 格式，默认为 true。
  • :keyname：在 Ceph 中注册的密钥名称。
  • :filename：保存密钥的位置。
  • :owner：密钥文件的所有者，默认为 root。
  • :group：密钥文件的组，默认为 root。
  • :mode：文件模式，默认为 '00640'。

ceph_cephfs

用于挂载 CephFS。

• Actions：:mount、:umount、:remount、:enable、:disable
• Parameters：
  • :directory：本地文件系统中挂载 CephFS 的位置。
  • :use_fuse：是否使用 ceph-fuse 挂载文件系统，默认为 true。
  • :cephfs_subdir：挂载的 CephFS 子目录。

ceph_pool

用于创建和删除 Ceph 存储池。

• Actions：:add、:delete
• Parameters：
  • :name：存储池的名称。
  • :pg_num：创建存储池时的 placement groups 数量。
  • :create_options：创建存储池时的选项（可选）。
  • :force：是否强制删除存储池及其数据。

4. 项目安装方式

请参考上述的安装指南，确保系统中安装了所需的 Chef 版本和依赖的 cookbooks，然后按照项目使用说明配置节点角色和属性。