一、单机部署Ceph的适用场景与价值

Ceph作为分布式存储系统的标杆，通常需要多节点构建高可用集群。但在开发测试、个人学习或资源受限的边缘计算场景中，单机部署Ceph具有独特价值：

开发验证：开发者可在本地环境模拟Ceph的核心功能（如RADOS块存储、RGW对象存储），无需搭建多节点集群
教学实验：通过单机环境快速理解Ceph的架构原理，包括OSD、MON、MDS等组件的交互机制
资源优化：在单台物理机或虚拟机上部署微型Ceph集群，适用于嵌入式系统或IoT设备的存储需求

需特别说明的是，单机部署的Ceph仅建议用于非生产环境。其核心缺陷包括：无数据冗余、单点故障风险、性能瓶颈明显。生产环境必须采用至少3个节点的分布式部署。

二、环境准备与前置条件

2.1 硬件配置要求

组件	最低配置	推荐配置
操作系统	Ubuntu 20.04/CentOS 8	Ubuntu 22.04 LTS
CPU	4核	8核以上
内存	8GB	16GB以上
磁盘空间	100GB可用空间	500GB以上（建议SSD）
网络	千兆网卡	万兆网卡（可选）

2.2 软件依赖安装

# Ubuntu系统示例
sudo apt update
sudo apt install -y ceph-deploy ceph-common ceph-mds ceph-mon ceph-osd
# CentOS系统示例
sudo yum install -y epel-release
sudo yum install -y ceph-deploy ceph-common ceph-mds ceph-mon ceph-osd

2.3 磁盘分区规划

建议采用独立磁盘部署OSD服务，避免与系统盘混用。可通过lsblk命令查看磁盘信息：

lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINT

典型分区方案：

/dev/sdb：用于OSD存储（建议XFS文件系统）
/dev/sdc：可选的WAL/DB分区（针对SSD设备）

三、单机部署核心流程

3.1 初始化部署目录

mkdir ~/ceph-cluster
cd ~/ceph-cluster

3.2 创建集群配置文件

生成ceph.conf基础配置：

[global]
fsid = $(uuidgen)  # 生成唯一集群ID
public network = 0.0.0.0/0  # 开发环境可简化网络配置
osd crush chooseleaf type = 0  # 单机环境禁用CRUSH分布
osd pool default size = 1  # 副本数设为1
osd pool default min size = 1
[mon]
mon initial members = mon0
mon host = $(hostname -I | awk '{print $1}')
[osd]
osd data = /var/lib/ceph/osd/$cluster-$id
osd journal size = 1024  # 日志大小(MB)

3.3 部署监控节点(MON)

ceph-deploy new mon0  # 创建初始监控节点
ceph-deploy mon create-initial

3.4 部署OSD存储节点

# 使用整块磁盘部署OSD
ceph-deploy osd create --data /dev/sdb mon0
# 验证OSD状态
ceph osd tree

3.5 部署MDS元数据服务器（可选）

若需使用CephFS文件系统：

ceph-deploy mds create mon0:mds0
ceph fs volume create cephfs  # 创建文件系统

四、关键配置优化

4.1 内存分配优化

修改/etc/ceph/ceph.conf添加：

[osd]
osd memory target = 4294967296  # 限制OSD内存使用(4GB)
osd max backfills = 1  # 减少后台恢复任务

4.2 日志级别调整

ceph tell osd.* injectargs --debug-osd 0/5  # 将OSD日志级别设为ERROR

4.3 性能调优参数

[global]
osd op thread timeout = 10  # 操作超时时间(秒)
osd client op priority = 60  # 客户端操作优先级

五、验证部署结果

5.1 集群健康检查

ceph -s
# 正常输出示例：
#   cluster:
#     id:     3a8f1b5e-...
#     health: HEALTH_OK
#   services:
#     mon: 1 daemons, quorum mon0
#     osd: 1 osds: 1 up, 1 in

5.2 存储功能测试

块设备测试

rbd create test_img --size 1G  # 创建块设备
rbd map test_img  # 映射到主机
mkfs.xfs /dev/rbd0  # 格式化
mount /dev/rbd0 /mnt  # 挂载测试

对象存储测试

radosgw-admin user create --uid=testuser --display-name="Test User"
# 获取访问密钥后，可使用s3cmd等工具测试

六、常见问题解决方案

6.1 OSD启动失败处理

现象：ceph osd tree显示OSD为down状态
排查步骤：

检查日志：journalctl -u ceph-osd@0 -f
验证磁盘权限：ls -l /var/lib/ceph/osd/ceph-0

重建OSD：

ceph-deploy osd destroy mon0:/var/lib/ceph/osd/ceph-0
ceph-deploy osd create --data /dev/sdb mon0

6.2 MON服务异常

现象：ceph quorum_status显示监控节点未达成法定人数
解决方案：

重启MON服务：systemctl restart ceph-mon@mon0
检查时间同步：timedatectl

重建MON（极端情况）：

ceph-deploy mon destroy mon0
ceph-deploy mon create mon0

6.3 性能瓶颈分析

使用ceph daemon osd.0 perf dump查看OSD性能指标，重点关注：

op_latency：操作延迟
apply_latency：提交延迟
commit_latency：持久化延迟

七、进阶应用场景

7.1 容器化部署

通过Docker部署微型Ceph集群：

FROM ceph/daemon:latest-luminous
RUN apt-get update && apt-get install -y ceph-osd
CMD ["/usr/bin/ceph-osd", "--foreground", "--id", "0", "--setuser", "ceph", "--setgroup", "ceph"]

7.2 与Kubernetes集成

使用Rook Operator管理单机Ceph：

apiVersion: ceph.rook.io/v1
kind: CephCluster
metadata:
  name: rook-ceph
spec:
  cephVersion:
    image: ceph/ceph:v16.2.7
  mon:
    count: 1
    allowMultiplePerNode: true
  storage:
    useAllNodes: false
    useAllDevices: false
    devices:
      - name: "/dev/sdb"

八、总结与建议

单机部署Ceph为开发测试提供了便捷的途径，但需严格限定使用场景。建议开发者：

定期备份/etc/ceph目录和/var/lib/ceph数据
使用ceph daemon osd.0 log last命令分析历史操作
关注Ceph官方文档的版本更新（当前最新稳定版为Quincy 17.2.6）

对于生产环境部署，建议参考Ceph官方文档的《多节点部署指南》，确保实现数据冗余和高可用性。单机部署的价值在于降低技术探索门槛，而非替代分布式架构。

单机部署Ceph：从入门到实践的完整指南