脱初心者！ Git ワークフローを理解して開発効率アップ

git workflow

Git – チーム開発に必須のバージョン管理システムですが、その真価を発揮するにはワークフローの理解が欠かせません。色々な人は Git の使い方を良く知っていますが、Git を仕事やワークフローに統合する方法を余り良く知らない人もいます。本記事では、Git をワークフローに組み込むことで、開発プロセスがどのように効率化され、チーム全体のパフォーマンスが向上するのかを解説します。Centralized Workflow から Forking Workflow まで、代表的な 9 つのワークフローの特徴を分かりやすく紹介します。それぞれのメリット・デメリット、そして最適なユースケースを理解することで、あなたのプロジェクトに最適なワークフローを選択し、開発をスムーズに進めましょう！

Centralized Workflow
Feature branching/GitHub Flow
Trunk Based Flow
Git Feature Flow
Git Flow
Enhanced Git Flow
One Flow
GitLab Flow
Forking Workflow

分かりやすくするために、同じコンセプトを説明するに一つ以上の図を使った場合があります。

Centralized Workflow

説明：

集中化ワークフローではプロジェクトにおけるすべての変更の単一の入力箇所として中央リポジトリを使用します。デフォルトの開発用ブランチは main と呼ばれ、すべての変更がこのブランチにコミットされます。集中化ワークフローでは main 以外のブランチは不要です。チームメンバー全員がひとつのブランチで作業し、変更を直接中央リポジトリにプッシュします。

メリット：

SVN のような集中型バージョン管理システムから移行する小規模チームに最適。

デメリット：

お互いのコードが邪魔になり (お互いの変更を上書きするように)、プロダクション環境にバグをい入れる可能性が高くて、複数のメンバいるチームでこのフローを使いにくい。

地図：

graph TD;
    A[Central Repository] -->|Clone| B1[Developer A's Local Repo]
    A -->|Clone| C1[Developer B's Local Repo]

    B1 -->|Make Changes| B2[Commit Changes]
    C1 -->|Make Changes| C2[Commit Changes]

    B2 -->|Push| A
    C2 -->|Push| A

    A -->|Pull| B1
    A -->|Pull| C1

Feature branching / GitHub Flow

説明：

すべての機能開発を main ブランチではなく専用のブランチで行う。main ブランチに壊れたコードは含まれない、いつもリリース出来るコードを含む。（master ブランチにあるものはすべてデプロイ可能だ）開発者はメインブランチからフィーチャーブランチを作成し、変更が完了したらプルリクエストを使ってメインブランチにマージする。 mergeの後にフィーチャーブランチを消す。開発者は絶対に直接にmainブランチにプッシュしない、いつもpull requestする。

メリット：

すぐに理解することが出来る (一番分かりやすいワークフロー)
main のコードベースに影響を与えることなく複数の開発者が別々のフィーチャー開発作業を行える
CI/CD の為に適す
プルリクエストの活用でブランチに関連した問題点を議論出来る
よくリリースするプロジェクトに使える/に適す
ウェブサイト開発のプロジェクトにように一つだけのバージョンが要るプロジェクトに適す
merge conflict が少ない

デメリット：

主なブランチがmainしかないので、異なるタスクを互いに分けて管理するのは少し難しくて、チームにとっては混乱した状況になる恐れがある
リリースと開発ような環境専用のブランチがない、本番環境でバグが発生しやすく
同時に複数のバージョンをサポートする事が必要なら、このワークフローを使えない
複数のfeature branchの完了が（同時に）長く時間かかったら行ったら、mergeするのは難しくなる

地図：

地図 1

Feature branching
source: https://www.atlassian.com/git/tutorials/comparing-workflows/feature-branch-workflow

地図 2

Feature branching
source: https://www.optimizely.com/optimization-glossary/trunk-based-development/

地図 3

GitHub Flow
source: https://www.gitkraken.com/learn/git/best-practices/git-branch-strategy

Trunk Based Development

説明：

エンジニアは、小さな変更をより頻繁にメインのコードベースにマージし、長期間のフィーチャーブランチで作業するよりも、トランク(mainブランチ)のコピーで作業する。多くの場合、featureブランチには特徴の一部しか含まれないため、featureブランチは小さくなる。 featureブランチをmainブランチにmergeする前にfeatureブランチをよくテストする。

GitHub Flow と似ている、二つの違いさがある

feature branchが完了するまで待たず、mainブランチにmergeする
小さいなチームの場合は小さなコード変更なら開発者は直接にmainブランチにプッシュ出来る

メリット：

merge conflictが一番少ないワークフロー
かりやすいワークフロー
CI/CD の為に適す
プルリクエストの活用でブランチに関連した問題点を議論出来る
よくリリースするプロジェクトに使える/に適す
ウェブサイト開発のプロジェクトにように一つだけのバージョンが要るプロジェクトに適す

デメリット：

フィーチャーが完了ずmainにmergeするので、mainブランチにバグを入れ恐れがある
フィーチャーが完了ずmainにmergeする為に、よくFeature Toggle/Flagを使られるけど、その為に経験を持っている開発者が必要
主なブランチがmainしかないので、異なるタスクを互いに分けて管理するのは少し難しくて、チームにとっては混乱した状況になる恐れがある
リリースと開発ような環境専用のブランチがない、本番環境でバグが発生しやすく
同時に複数のバージョンをサポートする事が必要なら、このワークフローを使えない

地図：

Trunk Based Development
source: https://www.optimizely.com/optimization-glossary/trunk-based-development/

Git Flow

説明：

mainとdevelopと言う 2 つの長期ブランチとさらにfeature、release、hotfix といった追加のブランチを特定の目的に使用する。ブランチの役割分担を明確にし、いつ、どのように相互作用するかを定義している。機能ブランチに加え、リリースの準備、メンテナンス、記録にも個々のブランチを使用する。

プロダクション環境のコードがmainブランチで保存される

メリット：

特別のreleaseブランチがあるので構造化されたリリースサイクルを持つプロジェクトに最適
デプロイ前に機能の広範なテストを必要な場合に適す。
プロジェクトをよく構造する (さまざまな種類のブランチがあるため、直感的に仕事を整理しやすい。)
同時にアプリケーションの複数のバージョンをサポート出来る

デメリット：

プロジェクトによって開発プロセスやリリースサイクルを複雑にしすぎ、遅らせる恐れがある。
(プロジェクトによって) CI/CD が難しい。
主なブランチがmainじゃなくて、developで、慣れるのが時間掛かる
よく同じコードを二つのブランチにmergeする必要があるので、mergeを忘れ、間違いやすい(release と hot-fix ブランチの場合)
Git History が分かりにくくなる
アプリケーションが一つだけのバージョンがある場合は進めじゃない
ほとんどの開発者や開発チームが実際に必要としているよりも複雑なのだ
複数のfeature branchの完了が（同時に）長く時間かかったら行ったら、mergeするのは難しくなる

地図：

地図 1

Git Flow
source: https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow

地図 2

Git Flow
source: https://www.gitkraken.com/learn/git/git-flow

地図 3

Git Flow
source: https://nvie.com/posts/a-successful-git-branching-model/

Enhanced Git Flow

説明：

Git Flowに似ている。develop、main、と言うブランチとfeatureブランチがある。 developブランチに蓄積されたものを放出するときは、厳密にはmainのスーパーセットだ。開発はdevelopブランチで行われ、mainブランチはデプロイブランチです。developブランチの準備ができると、main ブランチの現在の先端が v1 などのアプリのバージョンとしてラベル付けされ、mainブランチのポインタがdevelopブランチを指すように変更されます。ホットフィックスがある場合はメインブランチに対して行われ、developブランチは続行されます。developブランチの準備ができると、メインブランチは v2 のタグで停止され、developブランチにマージされます（v3 になります）。開発はdevelopブランチでして、リリースする時にdevelopブランチ名をmainに変わって、リリースバージョンをtagで書く。 featureブランチはdevelopにmerge`する

メリット：

ブランチの種類が少ない (Git Flow より分かりやすい)
リリースブランチと開発ブランチは別々
GitHub Flow よりもっと整理され、構造化されている

デメリット：

余り人気がないワークフロー
レポゾトリを運用する人は経験と技術が必要

地図：

Enhanced Git Flow
source: https://www.toptal.com/gitflow/enhanced-git-flow-explained

Git Feature Flow

説明：

production、stage、deployment、featureと言うブランチがある。 featureはproductionブランチに基づう。

flowchart LR
    branch1(feature) -- merge --> branch2(development) -- merge --> branch3(stage) -- merge --> branch4(production)

流れじゃなくて、以下の通りです。

flowchart LR
    branch1(feature) -- merge --> branch2(development)
    branch1 -- merge --> branch3(stage)
    branch1 -- merge --> branch4(production)

メリット：

色々の環境のブランチがある

デメリット：

余り人気がない
(他のワークフローと逆から)分かりにくい
不要なステップが多い(同じコードを各ブランチにmergeする)
merge conflictが多い

地図：

地図 1

gitGraph
    commit
    branch develop
    branch stage
    commit
    commit
    commit
    checkout main
    commit
    commit
    commit
    checkout stage
    commit
    commit
    commit
    checkout develop
    commit
    commit
    commit
    commit
    checkout main
    branch feature
    commit
    commit
    commit
    checkout main
    commit
    commit
    checkout stage
    merge feature
    checkout feature
    checkout develop
    merge feature
    checkout main
    merge feature

地図 2

Git Feature Flow
source: https://medium.com/dev-managers-handbook/git-feature-flow-125d28dfef1e

GitLab Flow

説明：

Gitlab Flowは 2 種類がある：Versioned Releaseと Continuous Release。

Versioned Release 三つのブランチがある:main、versionとfeature。各リリースには、mainブランチをベースにしたリリースブランチを作成。featureブランチをmainブランチにmergeする。バグ修正は、リリースブランチにマージする前に、まずメインブランチにマージすべき。

Continuous Release mainとproduction、featureと言うブランチ(とpreproductionような環境ブランチ)がある。開発はmainブランチでし、リリースする時にmainブランチをproductionブランチにmergeする。（preproductionブランチがあったら、productionにmerge前に、preproductionにmergeする） main、productionとpreproductionブランチに直接にmergeしず、pull requestする。

flowchart LR
    b1(Master) -- merge --> b2(Pre-Production) -- merge --> b3(Production)

両方の種類でもmergeの後、featureブランチを消す。

メリット：

フレキシブル
（Versioned Release の場合は）アプリケーションの複数のバージョンをサポート出来る
（ Continuous Release の場合は）アプリケーションの一つだけのバージョンもサポート出来る
（ Continuous Release の場合は）CI/CD は導入出来る
Git Flow と Enhanced Git Flow より分かりやすい
GitHub Flow よりもっと整理され、構造化されている

デメリット：

一番分かりやすいワークフローじゃない (GitHub Flow が一番分かりやすい)
一番整理され、構造化されているワークフローじゃない
Merge Conflict が起こる恐れがある

Versioned Release の地図:

Gitlab Flow Versioned release
source: https://www.gitkraken.com/learn/git/best-practices/git-branch-strategy

Continuous Release の地図：

Gitlab Flow
source: https://github.com/jadsonjs/gitlab-flow

地図 2

Gitlab Flow
source: https://github.com/jadsonjs/gitlab-flow

One Flow

説明：

Git Flowに似ているけど、違いさはdevelopブランチがない、開発はmainブランチでする。 mainブランチにmergeした後にmergeしたブランチを消す(featureとかreleaseとかhot-fix)

メリット：

Git Flow より分かりやすい
GitHub Flow より組織的

デメリット：

CI/CD に余り最適じゃない
merge conflict がよく起こる恐れがある

地図：

gitGraph
    commit
    commit
    commit
    branch feature_a
    checkout feature_a
    commit
    checkout main
    commit
    branch release1
    commit
    commit
    commit id: "v1.0"
    checkout main
    merge release1
    checkout feature_a
    commit
    checkout main
    merge feature_a
    commit

Forking Workflow

説明：

このワークフローを他のワークフロー一緒に使うはずです。外部の貢献者がメインのリポジトリに直接アクセスせずに作業できるようにするものである。貢献者は、メインリポジトリに直接アクセスすることなく作業を行うことができます。開発者はメインリポジトリのフォーク（個人的なコピー）を作成し、そこに変更を加えます。そこに変更を加えます。そして、その変更をメインリポジトリに統合するためにマージリクエストを提出します。メインリポジトリに統合します。単一のサーバーサイドリポジトリを「中央」のコードベースとして使う代わりに、すべての開発者に独自のサーバーサイドリポジトリを提供します。つまり、各開発者はひとつではなくふたつの Git リポジトリを持つことになります。プライベートなローカルリポジトリと、パブリックなサーバーサイドリポジトリです。フォークワークフローは、公開オープンソースプロジェクトでよく見られます。

このワークフローを他のワークフローと一緒に使える

メリット：

オープンソースプロジェクトに最適

デメリット：

オープンソースプロジェクトじゃない場合は、プロジェクトに不要なステップをもたらす。

結論

全ての条件を満たすワークフローがない、一番良いワークフローもないです。どのワークフローを使うのはプロジェクトによって、チームのよって、多くの場合は好みによってです。上のワークフローは決まりじゃないので、色々な会社は自分の理解、条件と好みによって色々な修正/調整し、使っています。

私の意見では GitLab Flow が良いです。理由は環境ブランチがあり、余り複雑じゃないのでです。

役に立つリンク

Centralized Workflow (集中化ワークフロー):

Trunk Based Flow:

Feature branching/GitHub Flow:

Git Flow:

Enhanced Git Flow:

https://www.toptal.com/gitflow/enhanced-git-flow-explained

Git Feature Flow:

https://medium.com/dev-managers-handbook/git-feature-flow-125d28dfef1e

GitLab Flow:

One Flow:

https://www.endoflineblog.com/oneflow-a-git-branching-model-and-workflow

Forking Workflow:

https://www.atlassian.com/git/tutorials/comparing-workflows/forking-workflow

General:

Cherry Peeked

Search This Blog