-
1. Gitの始め方
- 1.1 バージョン管理について
- 1.2 Gitの歴史
- 1.3 Gitとは?
- 1.4 コマンドライン
- 1.5 Gitのインストール
- 1.6 Gitの初回セットアップ
- 1.7 ヘルプの利用
- 1.8 まとめ
-
2. Gitの基本
- 2.1 Gitリポジトリの取得
- 2.2 リポジトリの変更を記録する
- 2.3 コミット履歴の表示
- 2.4 様々な「元に戻す」
- 2.5 リモートでの作業
- 2.6 タグ付け
- 2.7 Git エイリアス
- 2.8 まとめ
-
3. Git ブランチ
- 3.1 ブランチとは
- 3.2 基本的なブランチとマージ
- 3.3 ブランチ管理
- 3.4 ブランチのワークフロー
- 3.5 リモートブランチ
- 3.6 リベース
- 3.7 まとめ
-
4. Gitサーバー
- 4.1 プロトコル
- 4.2 サーバーへのGitの導入
- 4.3 SSH公開鍵の生成
- 4.4 サーバーのセットアップ
- 4.5 Gitデーモン
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 サードパーティのホスティングオプション
- 4.10 まとめ
-
5. 分散Git
- 5.1 分散ワークフロー
- 5.2 プロジェクトへの貢献
- 5.3 プロジェクトの管理
- 5.4 まとめ
-
6. GitHub
- 6.1 アカウントのセットアップと設定
- 6.2 プロジェクトへの貢献
- 6.3 プロジェクトの管理
- 6.4 組織の管理
- 6.5 GitHubのスクリプト化
- 6.6 まとめ
-
7. Gitのツール
- 7.1 リビジョンの選択
- 7.2 対話的なステージング
- 7.3 スタッシュとクリーン
- 7.4 作業に署名する
- 7.5 検索
- 7.6 履歴の書き換え
- 7.7 Resetの解明
- 7.8 高度なマージ
- 7.9 Rerere
- 7.10 Gitを使ったデバッグ
- 7.11 サブモジュール
- 7.12 バンドリング
- 7.13 置換
- 7.14 認証情報ストレージ
- 7.15 まとめ
-
8. Gitのカスタマイズ
- 8.1 Gitの設定
- 8.2 Git属性
- 8.3 Gitフック
- 8.4 Gitによるポリシーの強制例
- 8.5 まとめ
-
9. Gitと他のシステム
- 9.1 クライアントとしてのGit
- 9.2 Gitへの移行
- 9.3 まとめ
-
10. Gitの内側
- 10.1 PlumbingとPorcelain
- 10.2 Gitオブジェクト
- 10.3 Gitリファレンス
- 10.4 Packfile
- 10.5 Refspec
- 10.6 転送プロトコル
- 10.7 メンテナンスとデータリカバリ
- 10.8 環境変数
- 10.9 まとめ
-
A1. 付録A: 他の環境におけるGit
- A1.1 グラフィカルインターフェース
- A1.2 Visual StudioでのGit
- A1.3 Visual Studio CodeでのGit
- A1.4 IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMineでのGit
- A1.5 Sublime TextでのGit
- A1.6 BashでのGit
- A1.7 ZshでのGit
- A1.8 PowerShellでのGit
- A1.9 まとめ
-
A2. 付録B: アプリケーションにGitを組み込む
- A2.1 コマンドラインGit
- A2.2 Libgit2
- A2.3 JGit
- A2.4 go-git
- A2.5 Dulwich
-
A3. 付録C: Gitコマンド
- A3.1 セットアップと設定
- A3.2 プロジェクトの取得と作成
- A3.3 基本的なスナップショット
- A3.4 ブランチとマージ
- A3.5 プロジェクトの共有と更新
- A3.6 検査と比較
- A3.7 デバッグ
- A3.8 パッチ適用
- A3.9 メール
- A3.10 外部システム
- A3.11 管理
- A3.12 プラミングコマンド
3.2 Gitのブランチ - 基本的なブランチとマージ
基本的なブランチとマージ
実世界で使うかもしれないワークフローでブランチとマージの簡単な例を見ていきましょう。次の手順に従います。
-
ウェブサイトで作業を行う。
-
作業中の新しいユーザーストーリーのためにブランチを作成する。
-
そのブランチで作業を行う。
この段階で、別の問題が致命的であり、ホットフィックスが必要だという連絡が入ります。次のことを行います。
-
本番ブランチに切り替える。
-
ホットフィックスを追加するためのブランチを作成する。
-
テスト後、ホットフィックスブランチをマージし、本番環境にプッシュする。
-
元のユーザーストーリーに戻り、作業を続ける。
基本的なブランチ操作
まず、プロジェクトで作業しており、すでにmaster
ブランチにいくつかのコミットがあるとしましょう。

会社が使用している課題追跡システムで、課題 #53 に取り組むことを決めたとします。新しいブランチを作成し、同時にそのブランチに切り替えるには、git checkout
コマンドに-b
オプションを付けて実行します。
$ git checkout -b iss53
Switched to a new branch "iss53"
これは以下の省略形です。
$ git branch iss53
$ git checkout iss53

ウェブサイトで作業を行い、いくつかのコミットをします。そうすると、iss53
ブランチがチェックアウトされている(つまり、HEAD
がそれを指している)ため、ブランチが先に進みます。
$ vim index.html
$ git commit -a -m 'Create new footer [issue 53]'

iss53
ブランチは作業によって先に進んだここで、ウェブサイトに問題があり、すぐに修正する必要があるという連絡が入ります。Gitを使用すると、行ったiss53
の変更と一緒に修正をデプロイする必要はなく、本番環境の修正を適用する前にそれらの変更を元に戻すのに多くの労力を費やす必要もありません。master
ブランチに切り替えるだけで済みます。
ただし、これを行う前に、作業ディレクトリまたはステージングエリアに、チェックアウトしようとしているブランチと競合するコミットされていない変更がある場合、Gitはブランチの切り替えを許可しないことに注意してください。ブランチを切り替える際には、クリーンな作業状態であることが最善です。これを回避する方法(つまり、スタッシュとコミットの修正)は、後でスタッシュとクリーンで説明します。今のところ、すべての変更をコミット済みと仮定して、master
ブランチに戻りましょう。
$ git checkout master
Switched to branch 'master'
この時点で、プロジェクトの作業ディレクトリは、課題 #53 に取り組む前とまったく同じ状態になり、ホットフィックスに集中できます。これは覚えておくべき重要な点です。ブランチを切り替えると、Gitは作業ディレクトリを、そのブランチに最後にコミットしたときの状態に戻します。Gitはファイルを自動的に追加、削除、変更して、作業コピーがそのブランチへの最後のコミット時の状態であることを保証します。
次に、ホットフィックスを作成する必要があります。完了するまで作業するためのhotfix
ブランチを作成しましょう。
$ git checkout -b hotfix
Switched to a new branch 'hotfix'
$ vim index.html
$ git commit -a -m 'Fix broken email address'
[hotfix 1fb7853] Fix broken email address
1 file changed, 2 insertions(+)

master
をベースにしたホットフィックスブランチテストを実行し、ホットフィックスが意図したものであることを確認したら、最後にhotfix
ブランチをmaster
ブランチにマージして本番環境にデプロイします。これはgit merge
コマンドで行います。
$ git checkout master
$ git merge hotfix
Updating f42c576..3a0874c
Fast-forward
index.html | 2 ++
1 file changed, 2 insertions(+)
このマージで「fast-forward」(早送り)というフレーズに気づくでしょう。マージしたhotfix
ブランチが指すコミットC4
が、現在いるコミットC2
の真に先行していたため、Gitは単にポインタを先に進めるだけです。別の言い方をすると、あるコミットを、そのコミットの履歴を辿ることで到達できる別のコミットとマージしようとするとき、マージすべき分岐した作業がないため、Gitはポインタを先に進めることで処理を簡素化します。これを「fast-forward(早送り)」と呼びます。
これであなたの変更はmaster
ブランチが指すコミットのスナップショットに含まれ、修正をデプロイできます。

master
がhotfix
に早送りされた非常に重要な修正をデプロイした後、中断される前に作業していた内容に戻る準備ができました。しかし、まずhotfix
ブランチを削除します。もはや必要ないためです。master
ブランチが同じ場所を指しています。これはgit branch
コマンドの-d
オプションで削除できます。
$ git branch -d hotfix
Deleted branch hotfix (3a0874c).
これで課題 #53 の作業中ブランチに戻り、作業を続けることができます。
$ git checkout iss53
Switched to branch "iss53"
$ vim index.html
$ git commit -a -m 'Finish the new footer [issue 53]'
[iss53 ad82d7a] Finish the new footer [issue 53]
1 file changed, 1 insertion(+)

iss53
での作業が続くここで注意すべきは、hotfix
ブランチで行った作業はiss53
ブランチのファイルには含まれていないということです。もしそれを取り込む必要があるなら、git merge master
を実行してmaster
ブランチをiss53
ブランチにマージするか、またはiss53
ブランチを後でmaster
に戻すことを決めるまで、それらの変更の統合を待つことができます。
基本的なマージ操作
課題 #53 の作業が完了し、master
ブランチにマージする準備ができたとしましょう。そのためには、以前にhotfix
ブランチをマージしたのと同様に、iss53
ブランチをmaster
にマージします。マージ先のブランチをチェックアウトし、git merge
コマンドを実行するだけです。
$ git checkout master
Switched to branch 'master'
$ git merge iss53
Merge made by the 'recursive' strategy.
index.html | 1 +
1 file changed, 1 insertion(+)
これは、以前に行ったhotfix
のマージとは少し異なります。この場合、開発履歴はより古い時点から分岐しています。現在いるブランチのコミットが、マージするブランチの直接の祖先ではないため、Gitは追加の作業を行う必要があります。この場合、Gitはブランチの先端が指す2つのスナップショットと、それらの共通の祖先を使用して、単純な3方向マージを行います。

ブランチポインタを単に先に進めるのではなく、Gitはこの3方向マージの結果として新しいスナップショットを作成し、それを指す新しいコミットを自動的に作成します。これはマージコミットと呼ばれ、複数の親を持つという点で特殊です。

これで作業がマージされたので、iss53
ブランチはもう必要ありません。課題追跡システムで課題を閉じ、ブランチを削除できます。
$ git branch -d iss53
基本的なマージの競合
時折、このプロセスはスムーズに進まないことがあります。マージしようとしている2つのブランチで、同じファイルの同じ部分を異なる方法で変更した場合、Gitはそれらをきれいにマージできません。課題 #53 の修正がhotfix
ブランチと同じファイルの同じ部分を変更した場合、次のようなマージの競合が発生します。
$ git merge iss53
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
Gitは新しいマージコミットを自動的に作成していません。競合を解決する間、プロセスを一時停止しています。マージの競合が発生した後、どのファイルがマージされていないかを確認したい場合は、git status
を実行できます。
$ git status
On branch master
You have unmerged paths.
(fix conflicts and run "git commit")
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: index.html
no changes added to commit (use "git add" and/or "git commit -a")
マージの競合があり、解決されていないものはすべて「unmerged」(マージされていない)としてリストされます。Gitは競合するファイルに標準的な競合解決マーカーを追加するため、手動でファイルを開いてそれらの競合を解決できます。ファイルには次のようなセクションが含まれます。
<<<<<<< HEAD:index.html
<div id="footer">contact : email.support@github.com</div>
=======
<div id="footer">
please contact us at support@github.com
</div>
>>>>>>> iss53:index.html
これは、HEAD
(マージコマンドを実行したときにチェックアウトしていたmaster
ブランチ)にあるバージョンがそのブロックの上部(=======
より上のすべて)であり、iss53
ブランチにあるバージョンが下部のすべてのように見えることを意味します。競合を解決するには、どちらか一方を選択するか、自分で内容をマージする必要があります。たとえば、このブロック全体を次のように置き換えることで、この競合を解決できるでしょう。
<div id="footer">
please contact us at email.support@github.com
</div>
この解決策には各セクションの一部が含まれており、<<<<<<<
、=======
、および>>>>>>>
の行は完全に削除されています。競合する各ファイルでこれらの各セクションを解決したら、git add
を各ファイルに対して実行して、解決済みとしてマークします。ファイルをステージングすることで、Gitで解決済みとしてマークされます。
これらの問題を解決するためにグラフィカルツールを使用したい場合は、git mergetool
を実行できます。これにより、適切なビジュアルマージツールが起動し、競合を手順を追って解決できます。
$ git mergetool
This message is displayed because 'merge.tool' is not configured.
See 'git mergetool --tool-help' or 'git help config' for more details.
'git mergetool' will now attempt to use one of the following tools:
opendiff kdiff3 tkdiff xxdiff meld tortoisemerge gvimdiff diffuse diffmerge ecmerge p4merge araxis bc3 codecompare vimdiff emerge
Merging:
index.html
Normal merge conflict for 'index.html':
{local}: modified file
{remote}: modified file
Hit return to start merge resolution tool (opendiff):
デフォルト以外のマージツール(この場合、コマンドがmacOSで実行されたため、Gitはopendiff
を選択しました)を使用したい場合は、「one of the following tools.」(以下のツールのいずれか)の後にサポートされているすべてのツールがリストされているのが上部に表示されます。使用したいツールの名前を入力するだけです。
注
|
複雑なマージの競合を解決するためのより高度なツールが必要な場合は、高度なマージでマージについて詳しく説明します。 |
マージツールを終了すると、Gitはマージが成功したかどうかを尋ねます。成功したとスクリプトに伝えると、ファイルが解決済みとしてステージングされます。git status
を再度実行して、すべての競合が解決されたことを確認できます。
$ git status
On branch master
All conflicts fixed but you are still merging.
(use "git commit" to conclude merge)
Changes to be committed:
modified: index.html
それで問題なければ、競合していたすべてのファイルがステージングされていることを確認したら、git commit
と入力してマージコミットを確定できます。デフォルトのコミットメッセージは次のようになります。
Merge branch 'iss53'
Conflicts:
index.html
#
# It looks like you may be committing a merge.
# If this is not correct, please remove the file
# .git/MERGE_HEAD
# and try again.
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# On branch master
# All conflicts fixed but you are still merging.
#
# Changes to be committed:
# modified: index.html
#
将来このマージを見る他の人にとって役立つと思われる場合は、このコミットメッセージを、マージをどのように解決したかについての詳細で修正し、行った変更が明らかでない場合はその理由を説明することができます。