1人で始まり、1人で終わるPull request入門


1人ではじまり1人で終わるPull Request

今回は一人でできるGitHubのPull Requestの練習について紹介します。

*当記事は実践的なチーム開発を想定した記事でありません。私が個人でPull Requestの練習をした内容をまとめたものです。

Pull Requestについて

Pull RequestとはGitHubの機能の一つでソースレビューや作成もしくは変更したソースコードの反映を行うために利用される機能です。


最近ではチーム開発にGit GitHubの導入をしている企業は多くなっています。

Gitのバージョン管理はとても優れていますが、開発に携わる人間が各々ソードコードの新規作成や変更などを自己判断で反映を行った場合、チームメンバーはひとつひとつ変更内容の確認を行う必要があり、チーム開発においてとても非効率的な作業が発生します。また、チームのリーダーや有識者によるコードレビューがない場合は変更した内容により障害の発生原因となる場合があります。

なのでPull Requestが存在します!

Pull Requestの流れは

上記のような流れで反映を行う前に人間を挟むことにより反映前にコードレビューが必ず発生するようになります。

雑な資料で申し訳ありません。

Pull Requestを実践する

はじめに

  • Gitのインストール

  • GitHubアカウント

上記項目が未完了の場合、先に完了させましょう。

Git

GitHub

リポジトリの作成を行う

まずはじめにリポジトリの作成を行います!

リポジトリはPublicPrivateお好きな方をお選びください。


次にローカルのリポジトリとリモートのリポジトリの紐付けを行います。

私はGitHubとSSHで接続をしているので、SSHを選択していますがお使いの環境にあわせて接続形式を選択してください。


リモートリポジトリにローカルの内容をpushを行い、GitHubのリポジトリの画面が更新されていれば準備完了です。

これで1人でPull Requestの練習を行う準備が完了しました!


Pull Requestを出してみる

まずローカルリポジトリに新規ブランチを作成しましょう。

git checkout -b develop

develop branchの作成ができました。次にソースコードを編集または新規作成を行い、コミットを行いましょう。

コミットが完了したらリモートリポジトリにpushしましょう。

git push origin HEAD

  1. develop branchがpushされていることを確認します。Compare & pull requestボタンがからPull requestの画面に移動できます。今回はこのボタンからの遷移はおこないません。

  2. 今回はPull requestを行うため pull requestsタブからpull requestを行います。


New pull requestボタンを押してpull requestを行います。


  1. Merge先のbranchとMergeするbranchを指定します。今回はdevelop branchmain branchにMergeします。

  2. commitのメッセージ内容を確認することができます。今回はcommitが1つなので1つしか表示されていませんが、commitの内容が複数ある場合は複数表示されます。

  3. 変更したファイルの内容を確認することができます。今回は新規のファイルを作成したので追加した内容のみ表示されています。一部削除をした場合は削除した内容が表示されます。

  4. Create pull requestボタンを押すことで確認ページに移動することができます。


  1. Pull requestのタイトルを記述する項目です。初期時はコミットの内容が表示されます。この項目はわかりやすい内容にしましょう。

  2. Pull requestのコメント内容を記述する項目です。①でタイトルの記述を行い、当項目でより詳しい内容を記述します。記述内容としてはどのような変更をしたのかもしくはレビューをして欲しい観点についてを記述をします。

  3. pull requestの内容を分別する。

  • Reviewers レビューをしてもらう人を選択する。

  • Assignees 担当した人間を選択する。

  • Labels どうのような作業かを分類かを選択する。

  • Proects どのプロジェクトにたいしてのpull requestかを選択する。

  • Miletone いつまでの期限の作業かを選択する。

  • Linked Issue Issueごとに作業を管理している場合、どの作業かを選択する。

*今回は1人で始まり、1人で終わるpull requestなのでReviewersは選択することはできません。

上記の内容が完了したらCreate pull requestボタンを押しましょう!


ついに最後の画面です。

本来であればレビュー担当者がコメントを記述することができますが、今回は1人での作業のため、自身のコードレビューを行いコメントをしましょう。

Merge pull reqestボタンを押すことでdevelop branchmain branchにMergeすることができます。ボタンを押すとpull reqeustのコメントを記述することができます。コメントの記述が完了したらConfirm Mergeボタンを押しましょう。


最後にdevelop branchを削除してGitHubでの作業は完了です!


リモートをローカルに反映する

リモートリポジトリとローカルリポジトリで差があるので、リモートリポジトリの内容をローカルリポジトリに反映しましょう。今回の場合、リモートリポジトリのmain branchdevelop branchをMergeした状態です。一方でローカルリポジトリのmain branchdevelop branchをMergeしていません。

なので、リモートリポジトリのmain branchをローカルのmain branchにpullしましょう。

git checkout main

まずmain branchに移動します。

git pull origin main

次にリモートのmain branchをローカルのmain branchにpullします。

git log

最後にMergeが正常に行えているかを確認します。

以上が1人で始まり、1人で終わるPull request入門です。

pull requestの練習がしてみたいが、やり方がわからないという人や擬似チーム開発を1人で練習してみたいひとは参考にしてください。