注意

本文档适用于 Ceph 开发版本。

克隆 Ceph 源代码仓库

要克隆 Ceph 源代码的某个分支,请前往github Ceph,选择一个分支(默认情况下),然后点击main by default), and click the 下载按钮。

要克隆整个 git 仓库,安装并配置git.

安装 Git

要安装git在 Debian/Ubuntu 上,运行以下命令:

sudo apt-get install git

要安装git在 CentOS/RHEL 上,运行以下命令:

sudo yum install git

您必须有一个github账户。如果您没有github账户,请前往github.com并注册。遵循设置 Git.

添加 SSH 密钥(可选)

要将代码提交到 Ceph 或使用 SSHgit@github.com:ceph/ceph.git) 克隆仓库,您必须为 github 生成 SSH 密钥。

提示

如果您只想克隆仓库,可以使用git clone --recursive https://github.com/ceph/ceph.git而无需生成 SSH 密钥。

github生成 SSH 密钥,运行以下命令:

ssh-keygen

要打印您刚刚生成的并将添加到您的github账户的 SSH 密钥,使用cat命令。(以下示例假设您使用了默认的文件路径。)

cat .ssh/id_rsa.pub

复制公钥。

前往您的github账户,点击“账户设置”(由“工具”图标表示),然后在左侧导航栏中点击“SSH 密钥”。

在“SSH 密钥”列表中点击“添加 SSH 密钥”,为密钥输入一个名称,粘贴您生成的密钥,然后点击“添加密钥”按钮。

克隆源代码

要克隆 Ceph 源代码仓库,运行以下命令:

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

运行git clone后,您应该拥有 Ceph 仓库的完整副本。

提示

确保您维护仓库中包含的子模块的最新副本。运行git status将告诉您子模块是否已过时。参见更新子模块 for more information.

cd ceph
git status

更新子模块

如果您的子模块已过时,运行以下命令:

git submodule update --force --init --recursive --progress
git clean -fdx
git submodule foreach git clean -fdx

如果您仍然遇到子模块目录的问题,使用rm -rf [directory name]删除目录。然后再次运行git submodule update --init --recursive --progress

选择一个分支

克隆源代码和子模块后,您的 Ceph 仓库将默认位于main分支,这是不稳定开发分支。您也可以选择其他分支。

  • main: 不稳定开发分支。

  • stable-release-name: 稳定版本的名称,例如活跃发布。例如Pacific

  • next: 发布候选分支。

git checkout main

由 Ceph 基金会带给您

Ceph 文档是一个社区资源,由非盈利的 Ceph 基金会资助和托管Ceph Foundation. 如果您想支持这一点和我们的其他工作,请考虑加入现在加入.