ceph /ceph

Ceph is a distributed object, block, and file storage platform

★ 17,231⑂ 6,568👁 617⑃ 73,893● 0▤ 0
C++NOASSERTIONCreated 2011-09-01ceph.io
+7
日增长
17,231
stars
6,568
forks
617
watchers
73,893
prs
0
issues
0
releases

README

Ceph - a scalable distributed storage system

See https://ceph.com/ for current information about Ceph.

 Status




 Contributing Code

Most of Ceph is dual-licensed under the LGPL version 2.1 or 3.0. Some
miscellaneous code is either public domain or licensed under a BSD-style
license.

The Ceph documentation is licensed under Creative Commons Attribution Share
Alike 3.0 (CC-BY-SA-3.0). 

Some headers included in the ceph/ceph repository are licensed under the GPL.
See the file COPYING for a full inventory of licenses by file.

All code contributions must include a valid "Signed-off-by" line. See the file
SubmittingPatches.rst for details on this and instructions on how to generate
and submit patches.

Assignment of copyright is not required to contribute code. Code is
contributed under the terms of the applicable license.


 Checking out the source

Clone the ceph/ceph repository from github by running the following command on
a system that has git installed:

	git clone [email protected]:ceph/ceph

Alternatively, if you are not a github user, you should run the following
command on a system that has git installed:

	git clone https://github.com/ceph/ceph.git

When the ceph/ceph repository has been cloned to your system, run the
following commands to move into the cloned ceph/ceph repository and to check
out the git submodules associated with it:

    cd ceph
	git submodule update --init --recursive --progress


 Build Prerequisites

section last updated 06 Sep 2024

We provide the Debian and Ubuntu apt commands in this procedure. If you use
a system with a different package manager, then you will have to use different
commands. 

. Install curl:

    apt install curl

. Install package dependencies by running the install-deps.sh script:

	./install-deps.sh

. Install the python3-routes package:

    apt install python3-routes


 Building Ceph

These instructions are meant for developers who are compiling the code for
development and testing. To build binaries that are suitable for installation
we recommend that you build .deb or .rpm packages, or refer to
ceph.spec.in or debian/rules to see which configuration options are
specified for production builds.

To build Ceph, follow this procedure: 

1. Make sure that you are in the top-level ceph directory that
   contains do_cmake.sh and CONTRIBUTING.rst.
2. Run the do_cmake.sh script:

       ./do_cmake.sh

   See build types.

3. Move into the build directory:

       cd build
4. Use the ninja buildsystem to build the development environment:

       ninja -j3

    [!IMPORTANT]
   
    Ninja is the build system used by the Ceph
    project to build test builds.  The number of jobs used by ninja is 
    derived from the number of CPU cores of the building host if unspecified. 
    Use the -j option to limit the job number if build jobs are running 
    out of memory. If you attempt to run ninja and receive a message that 
    reads g++: fatal error: Killed signal terminated program cc1plus, then 
 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON