注意
本文档适用于 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:稳定的名称,活跃版本。例如Pacificnext:发布候选分支。
git checkout main