A.2.使用 Git ============ A.2.1.简介 ---------- 从 2020 年 12 月起，FreeBSD 使用 git 作为主要的版本控制系统来存储所有 FreeBSD 的基本源代码和文档。从 2021 年 4 月起，FreeBSD 使用 git 作为唯一的版本控制系统来存储所有的 FreeBSD ports。 **注意** Git 通常是一个开发者工具。用户可能更喜欢使用 ``freebsd-update`` (`“更新 FreeBSD” `__) 来更新 FreeBSD 基本系统，以及 ``git`` (`“使用 ports” `__) 来更新 FreeBSD ports。 这一节演示了如何在 FreeBSD 系统上安装 Git 并使用它来创建 FreeBSD 源代码仓库的本地拷贝。 A.2.2.安装 ---------- Git 可以从 ports 中安装，也可以作为一个软件包安装。 .. raw:: latex \diilbookstyleinputcell .. code:: shell-session # pkg install git A.2.3.运行 Git -------------- 要获取一个干净的源码副本到本地目录，请使用 ``git clone``\ 。这个目录下的文件被称为 *工作树*\ 。 Git 使用链接来指定一个仓库。有三个不同的仓库，\ ``src`` 是指 FreeBSD 系统的源代码，\ ``doc`` 是指文档，而 ``ports`` 则是指 FreeBSD ports。这三个仓库都可以通过两种不同的协议到达：HTTPS 和 SSH。例如，链接 https://git.FreeBSD.org/src.git 指定了 src 仓库的主分支，并使用了 https 协议。 **表 1. FreeBSD Git 仓库的链接表** ============================== ========================================================================= 项目 **Git 链接** ============================== ========================================================================= 只读 src 仓库，使用 HTTPS `https://git.FreeBSD.org/src.git `__ 只读 src 仓库，使用 anon-ssh ssh://anongit@git.FreeBSD.org/src.git 只读 doc 仓库，使用 HTTPS `https://git.FreeBSD.org/doc.git `__ 只读 doc 仓库，使用 anon-ssh ssh://anongit@git.FreeBSD.org/doc.git 只读 ports 仓库，使用 HTTPS `https://git.FreeBSD.org/ports.git `__ 只读 ports 仓库，使用 anon-ssh ssh://anongit@git.FreeBSD.org/ports.git ============================== ========================================================================= 由项目成员维护的外部镜像也可以使用，请参考\ `外部镜像 `__\ 部分。 要克隆一份 FreeBSD 系统源代码的副本。 .. raw:: latex \diilbookstyleinputcell .. code:: shell-session # git clone -o freebsd https://git.FreeBSD.org/src.git /usr/src ``-o freebsd`` 选项了指定了源；根据 FreeBSD 文档的惯例，源被假定为 ``freebsd``\ 。因为初始检出必须下载远程仓库的完整分支，所以可能需要一些时间。请耐心等待。 最开始的工作树包含主分支的源代码，对应的是 CURRENT。要切换到 13-STABLE： .. raw:: latex \diilbookstyleinputcell .. code:: shell-session # cd /usr/src # git checkout stable/13 可以用 ``git pull`` 更新工作树。要更新上面的例子中创建的 **/usr/src**\ ，请使用： .. raw:: latex \diilbookstyleinputcell .. code:: shell-session # cd /usr/src # git pull --rebase 更新比检出要快得多，只传输有变化的文件。 A.2.4.基于网络的资源库浏览器 ---------------------------- FreeBSD 项目使用 cgit 作为基于网络的版本仓库浏览器：\ https://cgit.FreeBSD.org/\ 。 A.2.5. 对于开发者 ----------------- 关于对存储库的写入权限的信息，请参见 `提交者指南 `__\ 。 A.2.6. 外部镜像 --------------- 这些镜像并不托管在 FreeBSD.org 中，但仍由项目成员维护。我们欢迎用户和开发人员拉取或浏览这些镜像上的仓库。目前正在接受对 ``doc`` 和 ``src`` GitHub 仓库的拉取请求；除此之外，项目与这些镜像的工作流程仍在讨论中。 **Codeberg** - doc: https://codeberg.org/FreeBSD/freebsd-doc - ports: https://codeberg.org/FreeBSD/freebsd-ports - src: https://codeberg.org/FreeBSD/freebsd-src **GitHub** - doc: https://github.com/freebsd/freebsd-doc - ports: https://github.com/freebsd/freebsd-ports - src: https://github.com/freebsd/freebsd-src **GitLab** - doc: https://gitlab.com/FreeBSD/freebsd-doc - ports: https://gitlab.com/FreeBSD/freebsd-ports - src: https://gitlab.com/FreeBSD/freebsd-src A.2.7. 邮件列表 --------------- 在 FreeBSD 项目中，关于 git 的一般使用和问题的主要邮件列表是 `freebsd-git `__\ 。更多细节，包括提交信息列表，请参见\ `邮件列表 `__\ 章节。 A.2.8. SSH 主机密钥 ------------------- - gitrepo.FreeBSD.org 主机密钥指纹： - ECDSA 密钥指纹是 ``SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA`` - ED25519 密钥指纹是 ``SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo`` - RSA 密钥指纹是 ``SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI`` - git.FreeBSD.org 主机密钥指纹： - ECDSA 密钥指纹是 ``SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w`` - ED25519 密钥指纹是 ``SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE`` - RSA 密钥指纹是 ``SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM`` 这些也作为 SSHFP 记录公布在 DNS 中。