注意

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

克隆 Ceph 源代码仓库

要克隆 Ceph 源代码的某个 Ceph 分支,请访问 github Ceph 仓库,选择一个分支(默认为 main),然后点击 下载 ZIP 按钮。

要克隆整个 git 仓库,请安装和配置 git

安装 Git

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

sudo apt-get install git

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

sudo yum install git

您必须拥有一个 github 账户。如果您没有 github 账户,请访问 github.com 并注册。按照 设置 Git 中的说明设置 git。

添加 SSH 密钥(可选)

要向 Ceph 提交代码或使用 SSH (git@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 会告诉您子模块是否已过时。有关更多信息,请参阅更新子模块

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 基金会 资助和托管的社区资源。如果您希望支持这项工作和我们的其他努力,请考虑 立即加入