[ English | 한국어 (대한민국) | Indonesia | 中文 (简体, 中国) | español (México) | English (United Kingdom) | Deutsch ]
设置和学习 GIT¶
注意
本节假定您已完成 账户设置 指南。
GIT¶
什么是 Git?¶
Git 是一个免费且开源的分布式版本控制系统,OpenStack 社区使用它来管理源代码和文档的更改。
Git 允许您
推送和测试 代码、文档、基础设施更改和 CI 配置
推送 规范
推送 功能用例
安装¶
Mac OS¶
访问 Git 下载页面 并点击 Mac OS X。
下载的文件应该是在您的下载文件夹中的 dmg 文件。打开该 dmg 文件并按照屏幕上的说明操作。
如果您使用软件包管理器 Homebrew,请打开终端并输入
brew install git
Linux¶
对于 Debian、Ubuntu 或 Mint 等发行版,请打开终端并输入
sudo apt install git
对于 RedHat、Fedora 或 CentOS 等发行版,请打开终端并输入
sudo dnf install git
对于 SUSE 发行版,请打开终端并输入
sudo zypper in git
Windows¶
Windows Subsystem for Linux (WSL) 在 Windows 10 Anniversary Update 或更高版本(build 1607+)中可用。您可以安装和运行现代 Linux 操作系统
所有常用工具,如 bash、git 和 SSH,都可以开箱即用。
虽然 Git 下载页面 提供了 Windows 安装二进制文件,但不幸的是,大多数 OpenStack 开发工具(例如 git-review)在 Windows 环境下将无法正常工作。
配置 Git¶
安装 Git 后,您需要对其进行配置。打开您的终端应用程序并发出以下命令,输入您的名字和电子邮件地址。您的贡献将以这种方式标识
git config --global user.name "Firstname Lastname"
git config --global user.email "your_email@youremail.com"
注意
使用账户设置期间使用的相同电子邮件地址。
学习 Git¶
您可以使用 Git Immersion 来完成 Git 学习教程。
作为参考,请使用 Git 参考和备忘单。
提交消息¶
提交消息是审查者首先看到的内容,并用作 git 日志中的描述。它们提供了仓库中更改历史的描述。提交消息在补丁合并后无法修改。
格式
摘要行
空行
正文
空行
页脚
注意
页脚应逐行输入,行之间没有空行。
摘要行¶
摘要行简要描述补丁内容。字符限制为 50 个字符。摘要行不应以句点结尾。如果更改在提交时未完成,请以 WIP 开头。
正文¶
正文包含正在解决的问题的解释以及为什么应该修复它,解决方案的描述,以及有关如何改进代码结构或引用其他相关补丁的额外可选信息。各行限制为 72 个字符。正文应包含与问题相关的所有重要信息,而无需假设读者了解问题的根源或可以访问外部站点。