如果读者初次使用Pull Request,最好自己创建一个来体验它是什么。如果读者已经熟悉Pull Request,可以跳过这一部分,并继续阅读有关Pull Request特性的内容。请按以下步骤进行:
1.打开相应的存储库,通过单击右上角的Fork创建一个存储库派生:https://github.com/wulfland/AccelerateDevOps。
在Fork中,导航到Chapter 3|Create a pull request(ch3_pullrequest/Create-PullRequest.md)。该文件还包含了指令,这样用户不需要在浏览器和本书之间来回切换。单击文件内容上方的Edit铅笔图标编辑该文件。
2.删除文件中标记的行。
3.添加几行随机文本。
4.通过删除超过允许长度的字符来修改一行。
5.提交更改,但不要直接提交到主分支。将它们提交到一个新的分支,如图3-2所示。
图3-2 将更改提交到新分支
6.浏览器将自动重定向到一个可以创建Pull Request的页面。输入标题和说明。请注意,在第2章介绍的issue的Markdown语法在这里也支持:表情符号(:+1:)、提及(@)、引用(#)、任务列表(-[])和语法突出显示的源代码( )。用户还可以指配工作负责人、标签、项目和里程碑。
在页面的顶部,可以看到目标分支(base)是main,而要集成的源分支是刚刚创建的分支。“Create pull request”按钮是一个下拉列表。用户还可以选择创建Pull Request草稿。现在通过单击“Create pull request”按钮创建一个Pull Request(参见图3-3)。
图3-3 为对文件所做的更改创建Pull Request
7.在Pull Request中,单击“Files changed”并注意对文件所做的更改:删除的行是红色的,添加的行是绿色的,修改的行是删除的行后面跟着添加的行。如果将鼠标悬停在这些线上,左侧会出现一个加号+图标。单击该图标则可以添加单行注释。按住图标并拖动它,则可以为多行添加注释。同样,注释具有与issue相同的所有丰富特性标记支持!添加一条注释,单击Add single comment(见图3-4)。
经典的代码审阅和Pull Request之间的重要区别在于用户可以更新Pull Request。这使得用户可以处理注释并共同处理issue,直到issue关闭为止。读者可以编辑文件并提交到新分支,以查看Pull Request是否会反映更改。
8.通过打开右上角的菜单并选择Edit file(参见图3-5),可以直接从Pull Request编辑文件。
9.通过添加新的文本行来修改文件。在创建Pull Request之前,将更改提交到创建的分支(参见图3-6)。
10.返回Pull Request,注意系统会自动显示所做的更改。读者可以在Files changed下查看文件中的所有更改,也可以在Commits下查看单个提交中的更改(参见图3-7)。
图3-4 向更改行添加注释
图3-5 在Pull Request中编辑文件
图3-6 提交对分支的更改
图3-7 对单个提交中的更改进行注释
11.如果读者初次接触GitHub上的Pull Request,有以下几个要点:
●Pull Request是关于一个分支到一个基本分支的更改。如果更新分支,则Pull Request将自动更新。
●可以使用GitHub中的丰富功能来协作完成所有更改:任务列表、提及、引用、源代码等。
●可以查看基于每个文件或基于每个提交的更改。这有助于区分重要的更改和不重要的更改(例如重构)。