GitHub Issueを用いた開発手順

公開:2020/12/13
更新:2021/02/04
2 min読了の目安(約2000字TECH技術記事

はじめに

今回は、Git Issueを用いた開発方法について書きたいと思います。完全に備忘録です。
今後よく使う予定なのでいちいち調べ直さなくてもいいようにまとめておきます😌

issueの作成手順

  1. GitHub上の該当プロジェクトのタブからIssuesを選択する
  2. New issueを選択
  3. issueのタイトルと内容を記入してSubmit new issueを押す(issueが追加される)
    • コメントでチェックボックス等を付けることが出来るので子タスクの管理としても便利

issueを用いた開発手順

  1. 登録されているissueに合わせて新たにブランチを切って開発を始める

    • git branch 新規ブランチ名_#issue番号としてissue番号を付けておくと今後見やすくて便利
      • git checkout 新規ブランチ名で作業ブランチに移動することを忘れない
    • ブランチの移動まで一括で行いたい場合は、git checkout -b 新規ブランチ名_#issue番号として実行する。-bオプションは「ブランチの作成(branchのb)」のこと。

  2. キリの良いところで適宜コミットする(git commit -m "コミットメッセージ #issue番号"

    • コミットする時必ず対応するissue番号を半角スペースを空けて付け加えること!

  3. 作業が完了したら適宜git pushする(全て終わってからじゃなくてもOK)

    • この時作業ブランチ宛にpushすることに注意!(git push origin 作業ブランチ名

  4. 作業が全て完了したらプルリクを作成し、リモートのmainブランチにmergeする

    • プルリクの際、コメント欄にclose #issue番号と書くと、mergeされる際に自動的にそのissueがcloseになるので便利
    • プルリクの流れは以下の通り
      • Compare & pull requestボタンを押す
      • Write欄にコメントを書く(変更点の記入 & close #issue番号の記入)
      • Create pull requestボタンを押す
      • File changedで変更差分を確認(コメントがあればコメント)
      • Conversationタブ内のMerge pull requestボタンを押す
      • Confirm mergeボタンを押す
      • Delete branchボタンを押してリモートの作業ブランチを削除する

  5. ローカルのmasterブランチをリモートと同じ状態にする(git pull origin main

    • git checkout mainでmainブランチに移動する
    • git pullしたあとはローカルでmerge commitが作成されるので、ここで一度git pushしてリモートのmainブランチを更新しておいたほうがいいかも。(因みに、このmerge commitの作成を回避するためには、git pull --rebaseコマンドを使うといいとかなんとか)
    • チーム開発においては「git fetch + git merge」の方が無難かも

  6. ローカルにある作業ブランチを削除する(git branch -d 作業ブランチ名

  7. 完了!以下また①〜⑥の繰り返し

 

参考にしたサイト