-
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 スマート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 Plumbingコマンド
3.2 Gitのブランチ - 基本的なブランチとマージ
基本的なブランチとマージ
実世界で使うようなワークフローで、ブランチとマージの簡単な例を見てみましょう。次のステップを踏みます。
-
ウェブサイトで作業を行う。
-
作業中の新しいユーザーストーリーのためにブランチを作成する。
-
そのブランチで作業を行う。
この段階で、別の問題が重要であり、ホットフィックスが必要だという連絡を受けます。次のことを行います。
-
本番ブランチに切り替える。
-
ホットフィックスを追加するためのブランチを作成する。
-
テスト後、ホットフィックスブランチをマージし、本番環境にプッシュする。
-
元のユーザーストーリーに戻り、作業を続ける。
基本的なブランチ作成
まず、プロジェクトで作業していて、すでにmaster
ブランチにいくつかのコミットがあるとします。

あなたの会社が使用するイシュートラッキングシステムで、課題 #53 に取り組むことを決定しました。新しいブランチを作成し、同時にそれに切り替えるには、-b
スイッチを付けてgit checkout
コマンドを実行します。
$ git checkout -b iss53
Switched to a new branch "iss53"
これは次のショートハンドです。
$ git branch iss53
$ git checkout iss53

ウェブサイトで作業を行い、いくつかのコミットを行います。これにより、iss53
ブランチがチェックアウトされているため(つまり、HEAD
がそれを指しているため)、iss53
ブランチが前方に進みます。
$ 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は作業ディレクトリを、そのブランチで最後にコミットしたときと同じ状態にリセットします。ファイルを自動的に追加、削除、変更して、作業コピーがそのブランチへの最後のコミット時にどのように見えたかを確認します。
次に、ホットフィックスを作成する必要があります。完了するまで作業するための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は単にポインタを前方に移動させます。別の言い方をすれば、最初のコミットの履歴をたどることで到達できるコミットと1つのコミットをマージしようとすると、マージする分岐した作業がないため、Gitはポインタを前方に移動させることで物事を単純化します。これを「fast-forward」と呼びます。
あなたの変更は、master
ブランチが指すコミットのスナップショットに含まれるようになり、修正を展開できます。

master
がhotfix
にfast-forward非常に重要な修正が展開された後、中断される前にしていた作業に戻る準備ができました。しかし、まず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つのスナップショットと、その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")
マージの競合があり、解決されていないものはすべて未マージとしてリストされます。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はファイルをステージングして解決済みとしてマークします。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
#
将来このマージを見る他の人にとって役立つと思われる場合は、このコミットメッセージを、マージをどのように解決したか、変更を加えた理由が明らかでない場合はその説明で修正できます。