内部开发者文档

Note

If you’re looking for how to use Ceph as a library from your own software, please see API 文档.

You can start a development mode Ceph cluster, after compiling the source, with:

cd src
install -d -m0755 out dev/osd0
./vstart.sh -n -x -l
# check that it's there
./ceph health

Todo

vstart is woefully undocumented and full of sharp sticks to poke yourself with.

Mailing list

The official development email list is ceph-devel@vger.kernel.org. Subscribe by sending a message to majordomo@vger.kernel.org with the line:

subscribe ceph-devel

in the body of the message.

Contents

• Cache pool
  • Purpose
  • Use cases
    • Read-write pool, writeback
    • Read-only pool, weak consistency
  • Interface
  • Tiering agent
    • HitSet metadata
    • Cache mode
    • Cache sizing
    • Other tunables
• Cephx 认证协议详细阐述
  • 简介
  • Getting Started With Authorization
  • Phase I:
  • Phase II
• Configuration Management System
  • The Configuration File
  • Metavariables
  • Reading configuration values
  • Changing configuration values
• CephContext
• 资料库结构
  • 如何生成对象资料库
• Installing Oprofile
  • Installation
  • Compiling Ceph for Profiling
  • Ceph Configuration
• CephFS delayed deletion
• 开发集群的部署
  • 用法
  • 选项
  • Environment variables
• Development workflows
  • Release Cycle
  • Merging bug fixes or features
  • Resolving bug reports and implementing features
  • Running and interpreting teuthology integration tests
  • Preparing a new release
  • Cutting a new stable release
  • Cutting a new development release
  • Publishing point releases and backporting
• 与 POSIX 标准的差异
• 为 Ceph 写作文档
  • 代码文档
  • 绘图
    • Graphviz
    • Ditaa
    • Blockdiag
    • Inkscape
• 纠删码存储池
  • 用途
  • Use cases
    • Cold storage
    • Cheap multidatacenter storage
  • Interface
• File striping
  • ceph_file_layout
• Filestore filesystem compatilibity
  • OSD journal replay of non-idempotent transactions
• Building Ceph Documentation
  • Clone the Ceph Repository
  • Install the Required Tools
  • Build the Documents
• 向 Ceph 贡献：开发者指南
  • 简介
  • 必备知识
    • 项目领袖
    • 历史
    • 软件许可
    • 源代码仓库
    • 问题跟踪器
    • 邮件列表
    • IRC
    • 补丁的提交
    • 从源码构建
    • 开发模式集群
  • 基本工作流
    • 问题跟踪器惯例
    • 拉取请求
  • 体系架构
    • RADOS
    • RGW
    • RBD
    • CephFS
• Kernel client troubleshooting (FS)
• Library architecture
• Debug logs
  • Performance counters
• Messenger notes
  • ceph_perf_msgr
• Monitor bootstrap
  • Logical id
  • Secret keys
  • Cluster fsid
  • Monitor address
  • Peers
  • Cluster creation
    • Names and addresses
    • Addresses only
    • Names only
  • Cluster expansion
    • Initially peerless expansion
    • Expanding with initial members
• Network Encoding
  • Conventions
    • Integers
    • Complex Types
    • Variable Arrays
    • Primitive Aliases
  • Structures
    • Optional
    • Pair
    • Triple
    • List
    • Blob
    • Map
  • Complex Types
    • utime_t
    • ceph_entity_name
• 网络协议
  • Hello
    • Banner
    • Connect
    • Connect Reply
  • MSGR Protocol
    • CEPH_MSGR_TAG_CLOSE (0x06)
    • CEPH_MSGR_TAG_MSG (0x07)
    • CEPH_MSGR_TAG_ACK (0x08)
    • CEPH_MSGR_TAG_KEEPALIVE (0x09)
    • CEPH_MSGR_TAG_KEEPALIVE2 (0x04)
    • CEPH_MSGR_TAG_KEEPALIVE2_ACK (0x05)
• Object Store Architecture Overview
• OSD class path issues
• Peering
  • Concepts
  • Description of the Peering Process
  • State Model
• Perf counters
  • Access
  • Collections
  • Schema
  • Dump
• PG （归置组）说明
  • 概览
  • 映射算法（简化的）
  • 用户可见的归置组状态
• 开发者指南（快速）
  • 开发
  • 开发集群的部署
  • 运行 RadosGW 开发环境
  • 运行单元测试
• RBD 增量备份
  • Header
  • Metadata records
    • From snap
    • To snap
    • Size
  • Data Records
    • Updated data
    • Zero data
  • Final Record
    • End
• RBD Layering
  • Command line interface
  • Implementation
    • Data Flow
    • Parent/Child relationships
    • Protection
    • Resizing
    • Renaming
  • Header changes
    • cls_rbd
    • librbd
• Ceph Release Process
  • 1. Build environment
  • 2. Setup keyring for signing packages
  • 3. Set up build area
  • 4. Update Build version numbers
  • 5. Create Makefiles
  • 6. Run the release scripts
  • 7. Create RPM Repo
  • 8. Create Debian repo
  • 9. Push repos to ceph.org
  • 10. Update Git
    • Point release
    • Development and Stable releases
• Notes on Ceph repositories
  • Special branches
  • Rules
• Sepia 社区测试实验室
• Session Authentication for the Cephx Protocol
  • Introduction
  • Storing the Key
  • Signing Messages
  • Checking Signatures
  • Adding New Session Authentication Methods
  • Adding Encryption to Sessions
  • Session Security Statistics
• Public OSD Version
• Wireshark Dissector
  • Using
  • Developing
• OSD 开发者文档
  • Backfill Reservation
  • Erasure Coded Placement Groups
    • Glossary
    • Table of content
      • Developer notes
        • Introduction
        • Reading and writing encoded chunks from and to OSDs
        • Erasure code library
        • Notes
      • Jerasure plugin
        • 简介
      • High level design document
        • Motivation
        • Client Writes
        • Peering and PG Logs
        • PGTemp
        • Client Reads
        • Distinguished acting set positions
        • Object Classes
        • Scrub
        • Crush
        • Recovery
        • Backfill
  • last_epoch_started
  • Map and PG Message handling
    • Overview
    • MOSDMap
    • MOSDPGOp/MOSDPGSubOp
    • CEPH_MSG_OSD_OP processing
    • Peering Messages
  • OSD
    • Concepts
    • Overview
  • OSD Internals
  • PG
    • Concepts
    • Peering Details and Gotchas
  • PG Removal
  • Recovery Reservation
    • Things to Note
    • See Also
  • Scrubbing Behavior Table
    • State variables
  • 快照
    • Overview
    • Ondisk Structures
    • Snap Removal
    • Recovery
    • SnapMapper
    • Split
  • Watch Notify
    • Overview
    • Watch Lifecycle
    • Notify Lifecycle
  • 回写抑制
• MDS 开发者文档
  • MDS 内部数据结构
• RADOS 网关开发者文档
  • Usage Design Overview
    • Testing
  • Admin Ops Nonimplemented
    • Get Object
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Head Object
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Get Zone Info
      • Syntax
      • Response Entities
      • Special Error Responses
      • Example Response
    • Add Placement Pool
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Remove Placement Pool
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • List Available Data Placement Pools
      • Syntax
      • Response Entities
    • List Expired Garbage Collection Items
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Manually Processes Garbage Collection Items
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Show Log Objects
      • Syntax
      • Request Parameters
      • Response Entities
      • Special Error Responses
    • Standard Error Responses
  • Rados Gateway S3 API Compliance
    • Naming code reference
    • Common Request Headers
    • Common Response Headers
    • Operations on the Service
    • Operations on Buckets
    • Operations on Objects