Cloning the Ceph Source Code Repository

    To clone the entire git repository, install and configure git.

    To install git on Debian/Ubuntu, execute:

    To install git on CentOS/RHEL, execute:

    1. sudo yum install git

    You must also have a github account. If you do not have a account, go to github.com and register.Follow the directions for setting up git at.

    If you intend to commit code to Ceph or to clone using SSH(git@github.com:ceph/ceph.git), you must generate SSH keys for github.

    Tip

    To generate SSH keys for github, execute:

    Get the key to add to your github account (the following exampleassumes you used the default file path):

    1. cat .ssh/id_rsa.pub

    Copy the public key.

    Go to your account, click on “Account Settings” (i.e., the‘tools’ icon); then, click “SSH Keys” on the left side navbar.

    Click “Add SSH key” in the “SSH Keys” list, enter a name for the key, paste thekey you generated, and press the “Add key” button.

    To clone the Ceph source code repository, execute:

    Tip

    Make sure you maintain the latest copies of the submodulesincluded in the repository. Running git status will tell you ifthe submodules are out of date.

    1. cd ceph

    If your submodules are out of date, run:

    Once you clone the source code and submodules, your Ceph repositorywill be on the master branch by default, which is the unstabledevelopment branch. You may choose other branches too.

    • master: The unstable development branch.

    • : The bugfix branch.