GitHubの機能を活用したGitHub Flowによる開発の進め方

takemikamiʼs note ‒ http://takemikami.com/
GitHubの機能を活⽤した
GitHub Flowによる開発の進め⽅
Copyright (C) Takeshi Mikami. All rights reserved. 1
三上威 - @takemikami
アーリース情報技術株式会社代表取締役社⻑
2019.6.12

はじめに
•テーマ
GitHubの機能を活⽤した
GitHub Flowによる開発の進め⽅
•内容
• GitHub Flowの概要
• GitHub Flowによる開発の流れ
• GitHub FlowのためのGitHub機能の活⽤
本資料で説明する内容の概要を⽰します

GitHub Flowの概要

GitHub Flowとは
• 次のフローで運⽤
• masterブランチは常にデプロイ可能な状態であること
• 開発を始める時は、masterからブランチを切り、開発内容がわかるようにブラン
チ名をつける
• ローカルPCの作業は、同じブランチ名でサーバ(GitHub)にpushする
• 意⾒を求めたり、教えて欲しいことがある場合は、Pull Requestを使う
• 開発ブランチは、誰かにレビューを依頼して承認をもらったら、masterにマージ
できる
• masterにマージしたら、直ちにデプロイする
GitHub Flowを紹介します
「シンプルさ」に特徴がある
Gitによる開発ワークフローのモデル

GitHub Flowのブランチモデル
• GitHub Flowのブランチモデルは以下のようになります
GitHub Flowのブランチモデルを⽰します
commit
branch
branch
commit
merge
merge
(rebase) merge
commit
master branch
descriptive branch
descriptive branch
開発を始める時は
masterからブランチを切る
masterにマージしたら
直ちにデプロイ
レビュー承認をもらったら
masterにマージできる
masterは常に
デプロイ可能な状態に
開発中はPullRequestを使って相談

GitHub Flowによる開発の流れ

• GitHub Flowでは、次の流れで開発を⾏います
• 開発の着⼿
• ローカルPCでの実装作業
• GitHubへのpush
• Pull Requestの発⾏
• Pull Requestのステータス確認
• Reviewの依頼
• Reviewの実施・承認
• 不具合や指摘事項の対応
• Mergeの実施
• デプロイ
GitHub Flowによる開発の流れを⽰します

GitHub FlowとCI・レビュー・デプロイの関連
GitHub FlowとCI・レビュー・デプロイの関連を図に⽰します
Developer GitHub Reviewer CI
development
environment
staging
environment
clone/pull (master branch)
branch
commit
push (descriptive branch)
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request

開発の流れ：開発の着⼿
開発を着⼿する際に⾏う⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
開発着⼿時は、
masterブランチをGitHubからローカルPCに取り込み、
ブランチを切ります

• ローカルPCにrepositoryをcloneします
$ git clone git@github.com:<organization>/<repository>.git
$ cd <repository>

• masterから開発作業⽤のブランチを切ります
• ローカルPCのブランチは以下のようになります
$ git checkout -b fix-something
$ git branch
* fix-something
master
ブランチ名は、開発する内容を⽰す適当な名称にします

開発の流れ：ローカルPCでの実装作業
ローカルPCでの実装作業を⾏う際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
ファイルを修正し
開発作業⽤のブランチにcommitします

開発の流れ：ローカルPCでの実装作業
• ローカルPC上でファイルを変更し、commitします
ローカルPCでの実装作業を⾏う際の⼿続きを説明します
$ git commit <file> -m <comment>

開発の流れ：GitHubへのpush
GitHubへpushする際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
開発作業⽤のブランチを
GitHubにpushします

開発の流れ：GitHubへのpush
• ファイルの変更&commitを⾏ったら、変更をGitHubにpushします
GitHubへpushする際の⼿続きを説明します
$ git push origin fix-something
GitHubにブランチが作成されます

開発の流れ：Pull Requestの発⾏
GitHubでPull Requestを作成する際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
GitHubでPull Requestを作成します

開発の流れ：Pull Requestの発⾏
GitHubでPull Requestを作成する際の⼿続きを説明します
• GitHubのUIからPull Requestを作成します

開発の流れ：Pull Requestのステータス確認
GitHubでPull Requestのステータスを確認する際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
Pull Requestの⽣成後、⾃動的に、
CIによるテスト・開発環境へのデプロイを
⾏うようにしておきます
必要に応じて
Pull Requestのコメント機能を使い、
開発に関する相談を⾏います

• CIサービスとの連携で、Pull Requestからテスト結果を確認できます
• 全てのcheckがpassedになるまでコードの修正を⾏います
※Deployment APIを利⽤するとデプロイの状況も確認できます

開発の流れ：Reviewの依頼
GitHubでReviewを依頼する際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
⾃動テスト・セルフレビュー・動作確認が
完了したらReviewを依頼します

開発の流れ：Reviewの依頼
• ⾃動テスト・セルフレビュー・動作確認が完了したら、
GitHubのUIからReviewを依頼します
GitHubでReviewを依頼する際の⼿続きを説明します

開発の流れ：Reviewの実施・承認
GitHubでReviewを実施する際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
Reviewerは
コード差分・開発環境のモジュールを参照して
レビューを⾏います
問題なければApproveします

開発の流れ：Reviewの実施・承認
• ReviewerはGitHubのUIから、コメントやApproveを⾏います
GitHubでReviewを実施する際の⼿続きを説明します

開発の流れ：不具合や指摘事項の対応
• テストやレビューで検出した不具合や指摘事項は、
修正してcommit/pushを⾏います
→「ローカルPCでの実装作業」〜「GitHubへのpush」と同じ⼿続き
不具合や指摘事項の対応する際の⼿続きを説明します

• masterブランチに変更があった場合は、以下のように追従します
• ローカルPCのmasterブランチを最新化します
• 開発作業⽤ブランチをmasterからrebaseします
• conflictが無ければ、GitHubにforce pushします
$ git checkout master
$ git pull
$ git checkout fix-something
$ git rebase master
$ git push origin fix-something -f

• rebase時にconflictが発⽣した場合は、以下のように解消させます
• conflictが発⽣すると以下のように表⽰されます
• conflictしているファイルを修正した後、rebaseをcontinueします
$ git rebase master
※省略※
CONFLICT (content): Merge conflict in README.md
※省略※
$ git st
※省略※
both modified: README.md
※省略※
$ git add README.md
$ git rebase --continue

開発の流れ：Mergeの実施
GitHubでmasterへのMergeを⾏う際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
テスト・レビューで問題が無くなったら
(=本番deploy可能な状態になったら)、
masterブランチにmergeします

開発の流れ：Mergeの実施
• GitHubのUIからMergeを⾏います
GitHubでmasterへのMergeを⾏う際の⼿続きを説明します

開発の流れ：デプロイ
デプロイを⾏う際の⼿続きを説明します
development
environment
staging
environment
branch
commit
clone
send status(OK/NG)
auto test
deploy
review request
check check
approve
merge deploy
pull request
masterブランチにmergeしたら、
⾃動でstaging環境にdeployします

GitHub FlowのためのGitHub機能の活⽤

• GitHub Flowを効率よく運⽤するためのGitHub機能を紹介します
• Pull Request機能
→masterブランチへのmergeする前の承認ワークフローとして使⽤
• BranchのProtect機能
→ステータス正常＆レビュー済みPull Request以外からの変更を禁⽌し、
masterブランチを常にデプロイ可能な状態に保つために使⽤
• CIとの連携機能
→Pull Requestの⽣成後のテスト実⾏を⾃動化するために使⽤
• CDとの連携機能
→開発環境・本番環境へのデプロイを⾃動化するために使⽤
GitHub Flowを効率よく運⽤するためのGitHub機能を紹介します

• CIサービスとの連携で、Pull Requestからテスト結果を確認できます
• 全てのcheckがpassedになるまでコードの修正を⾏います
※Deployment APIを利⽤するとデプロイの状況も確認できます
CIとの連携機能によって、
テスト結果をステータスに反映
BranchのProtect機能によって、
ステータス正常＆レビュー済みで無ければ、
Merge出来ないように制御

BranchのProtect機能
• GitHub Flowでは
『masterブランチは常にデプロイ可能な状態であること』が必要
→ masterブランチに誤った修正が⼊らないようにしたい
• BranchのProtect機能で以下のような条件を設定
• レビューを必須にする
• codeownerを設定しておくと、指定レビューアのレビューを必須に出来る
• CIの成功を必須にする
• 「Require status checks to pass before merging」以下で対象とするCIを指定可能
• Pull Requestをマージできる⼈を制限する
BranchのProtect機能で設定したい項⽬について⽰します

GitHubの機能を活用したGitHub Flowによる開発の進め方

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à GitHubの機能を活用したGitHub Flowによる開発の進め方

Similaire à GitHubの機能を活用したGitHub Flowによる開発の進め方 (20)

Plus de Takeshi Mikami

Plus de Takeshi Mikami (20)

GitHubの機能を活用したGitHub Flowによる開発の進め方