git メモ

利用事例

複数人でプレイブックの編集を行う場合を想定しています。

ローカル PC-A で ansible プレイブックを作成
ansible サーバにプレイブックをアップロードする
アップロードされたファイルを PC-B でダウンロードして編集したい
PC-A, PC-B で相互に編集したファイルを ansible サーバにアップロードしたい
以上のファイル変更点を履歴として残して、変更点ごとに復元出来るようにしたい

仕組の概要

プレイブックやディレクトリを リポジトリ という入れ物で管理します。
ローカルで編集したファイルをリモートにアップロードしたり、リモートのファイルをローカルにダウンロードしたりし、編集したファイルは修正内容含め履歴として管理することが出来ます。

用語

ワークツリー

実際に作業しているディレクトリ。

インデックス

ワークツリーの変更内容を記録しておく場所です。
ここに追加された情報をもとにリポジトリにコミットしていきます。インデックスにないファイルはコミット出来ません。

リポジトリ

ファイルやディレクトリの状態を記録する場所です。ワークツリーのことです。ローカルとリモート用があります。リポジトリの中に ブランチ という履歴の流れを分岐して管理するものがあります。

ブランチ

統合ブランチとトピックブランチがあります。
ローカル、リモートいずれにも master というブランチが存在します。これを統合ブランチとします。 master は全てのプレイブックが集約されている状態です。

トピックブランチは機能追加やバグ修正など課題単位で作成する場合等に利用します。例えば一部のプレイブックを試験的に修正し、テストする場合、ローカルに test というブランチを作成し、そこでファイルの修正を行います。

その後、test を master にマージすることで最終的な反映とする、といった利用法になります。統合ブランチには全てのファイル・ディレクトリを集約させ、トピックブランチにはその部品となるファイル・ディレクトリが配置されているというイメージです。

統合・トピックブランチを分ける利点は、別ブランチで編集を行うことで統合ブランチに直接的な影響を与えずにファイルの編集を行えることです。
また修正起点がブランチごと(編集ファイル群)に細かく分かれるため、修正箇所を追跡しやすくなります。

HEAD

今いるブランチの最新のコミットのことです。

コミット

ファイルやディレクトリの追加・変更等をリポジトリに記録することです。

プッシュ

ファイルやディレクトリの変更点を対向のブランチにアップロードさせることです。例えば、ローカルブランチの内容をリモートブランチに反映させます。

プル

ファイルやディレクトリの変更点を対向のブランチからダウンロードすることです。例えば、リモートブランチの内容をローカルブランチに反映させます。

マージ

ローカルのブランチ A とブランチ B を統合させることです。

環境準備

windows git for windows
linux $ sudo yum install git #RHEL $ sudo apt install git #Debian

利用方法

利用事例ごとにまとめました。

リモート git リポジトリのプレイブックをまとめてローカル PC にダウンロード

$ cd GIT_DIR
$ git clone ssh://root@172.17.0.120/var/www/html/git/ansible.git

ローカル PC で書いたコードを ansible サーバにアップロードする

$ cd GIT_DIR
$ git add <FILE> or DIR_NAME #インデックスに追加
$ git commit -m "COMMIT_COMMENT" #変更点のコメントを記載する
$ git push origin master #リモートリポジトリにアップロード

$ git push リモートリポジトリローカルブランチ名 #上記は origin がリモートリポジトリのエイリアス

リモート git リポジトリの変更点をダウンロードする

$ git pull

強制的に pull する

git pull 後に誤ってファイルを削除してしまった場合等。

$ git fetch origin master
$ git reset --hard origin/master

ローカル PC のファイル状態を確認

modified ローカルだけの変更点
Untracked files まだアップロードしていないファイル or ディレクトリ

$ git status
On branch master
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   inventory/inventory.ini
        modified:   roles/common/tasks/main.yml

Untracked files:
  (use "git add <file>..." to include in what will be committed)

        document/
        site.retry
        site.yml

no changes added to commit (use "git add" and/or "git commit -a")

特定ファイルの過去の状態を確認

ファイルのコミット履歴を確認 $ git log <FILE>
あるコミット時点での差分を表示 $ git diff <HASH> <FILE> $ git diff HEAD^ #直前のコミットとその 1 つ前のコミットの比較
特定のコミット時点でのファイル内容を表示 $ git blame <HASH> <FILE>

git add したファイルを取り消す

commit する前に add したファイルを取り消したいときに。 $ git status #new file が追加されたファイル $ git reset head <FILE> #取り消す処理

git commit の打ち消し

取り消した履歴(git log)が残ります。コミットログはコマンド実行後、直書き出来ます。

特定のコミットだけを打ち消す場合 $ git revert head #直前のコミットの打ち消し $ git revert <HASH> #git log のハッシュ値を指定して打ち消し $ git revert --no-edit #コメントなしでコミットする場合
2 つ以上を打ち消す場合 $ git revert -n <HASH> #index に戻すだけでコミットはしない $ git commit -m "まとめてコミット" #revert したファイルをまとめてコミット ``

git commit の取り消し

履歴(git log)からも取り消したログが消えてしまうので注意。 $ git reset --hard head^ #直前のコミット取り消し・ローカルリポジトリの内容も戻したいとき $ git reset --soft head^ #直前のコミット取り消し・ローカルリポジトリの内容はそのまま $ git reset <HASH> #git log の*commit に記載のハッシュ値指定でも OK。指定したハッシュ値のコミット状態に戻ります。

$ git reflog #コミット履歴を表示 $ git reset --hard HEAD@{1} #HEAD{1}の時点まで戻す

ブランチ関連

ブランチの変更

ルールとしてリモートの master ブランチに全てのファイルが集約される運用だとします。まずローカルの master ブランチをコピーして、ローカル上の別ブランチで作業して、リモートの master ブランチにマージしたりします。

ブランチの作成とマージ

$ git branch BRANCH_NAME #ブランチの作成 $git branch -b BRANCH_NAME でチェックアウトも同時に行う
$ git checkout BRANCH_A #ブランチの変更
何かしらファイルをadd,commit
$ git merge BRANCH_B #カレントブランチ BRANCH_A に BRANCH_B がマージされる。

ブランチのリベース

ブランチの削除

$ git branch -a #ローカルとリモートのブランチを表示
$ git branch -d BRANCH_NAME #ローカルブランチを削除
$ git push -d origin BRANCH_NAME #リモートブランチを削除

ローカルで削除したファイルをリストア

直前のコミット状態に戻す $ git checkout -f
ファイルを指定して戻す $ git checkout -f <FILE>

作業中の状態を一時保存する

別ブランチで作業するため、現在の変更点を一時保存する場合に利用します。
一時保存せずに別ブランチに移動してしまった場合、保存していなかった内容が別ブランチに反映されてしまいます。 ※運用としては一時保存せずに一旦コミットして push してしまう方法も OK です。

$ git stash #一時保存。コミット中の情報も保存される。
$ git stash list #一時保存された状態リストの表示
$ git stash show #一時保存されたファイルの一覧表示
$ git stash list -p #変更されたファイルの内容表示
$ git stash apply stash@{0} #一時保存から復帰。{}の中はgit stash listで確認した値を指定
$ git stash drop stash@{0} #一時保存情報を削除。
$ git stash pop stash@{0} #復帰と一時保存情報削除を同時に行う。

特定のファイルを git 管理から除外したい場合

$ cd GIT_DIR
$ vi .gitignore
*.iso
*.DS_Store
*.retry
*.log
*.tmp

git 管理対象から削除したいとき

$ git rm <FILE> $ git rm -r DIR_NAME $ git rm --cached <FILE> #ローカルのファイルを残したまま管理対象から外す場合

リモートリポジトリ関連

リモートリポジトリの一覧を表示 $ git remote -v
接続するリモートリポジトリを追加 $ git remote add origin ssh://USER@192.168.0.1/var/www/html/ansible.git
接続しているリモートリポジトリを解除 $ git remote rm origin
リモートリポジトリの情報を表示 $ git remote show origin
ローカルの追跡ブランチの情報を更新（リモートブランチの情報と同期） $ git remote update -p #-p は prune?

ログ関連

HEAD(最新コミット)の遷移を確認 $ git reflog #HEAD の遷移を表示 git reset で戻すときに便利 # git reset --hard HEAD@{1}

コミットログコミットのログをコメント付きで表示します。 $ git log #過去のコミットログを表示。コミットコメント付き。 $ git log --name-status #変更したファイルを表示 $ git log -- DIR or FILE #特定のディレクトリやファイルのみ $ git log --author='z00080' #コミットした人の名前で表示 $ git log --merges #マージのみ。 --no-merges はマージを除外。
コミットログの詳細表示コミットログの詳細を表示します。 $ git show #最新コミットとの差分表示 $ git show COMMIT_NO # $git reflog で確認した値
インデックスとの差分を表示 $ git diff #カレントブランチと最新コミットの差分 $ git diff HEAD^1 #インデックス指定も可能 $ git diff --name-only #変更点のあるファイルを表示 $ git diff --cached #git add した後にインデックスと最新のコミットの差を確認
リモートサーバとの変更分を確認

$ git fetch
$ git log origin/master

マージの衝突を解消する

ブランチ test1 と test2 があり、その中に同じ編集ファイルがあり、編集内容が衝突（競合）することがあります。その際は下記のような対応を行います。

git merge を使う場合

ローカルブランチで衝突発生。

衝突発生

$ git merge test2
Auto-merging test2
CONFLICT (content): Merge conflict in test2
Automatic merge failed; fix conflicts and then commit the result.

衝突ファイルの調査 test2 が衝突していることが分かります。

$ git status
On branch test1
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Unmerged paths:
  (use "git add <file>..." to mark resolution)

        both modified:   test2

衝突内容を表示

===で区切られた上が test1 ブランチ、下が test2 ブランチの内容です。

修正前

$ vi test2
<<<<<<< HEAD
add from test1
=======
add from test2
>>>>>>> test2

修正後

$ vi test2
add from test1
add from test2

コミット

ブランチ test1 で。

$ git add test2
$ git commit -m "merge test1 and test2"

push 時に衝突発生

ローカル → リモートへの push で衝突発生。リモートの方が最新であるため、ローカルで pull せずに push してしまった状況です。

git push で衝突発生

$ git push origin master
root@172.17.0.120's password:
To ssh://172.17.0.120/var/www/html/git/test.git
 ! [rejected]        master -> master (fetch first)
error: failed to push some refs to 'ssh://root@172.17.0.120/var/www/html/git/test.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

衝突解消「test」というファイルで衝突が発生しています。

$ git fetch
$ git merge origin/master
Auto-merging test
CONFLICT (content): Merge conflict in test
Automatic merge failed; fix conflicts and then commit the result.

衝突内容の修正 $ vi test
改めてプッシュ

$ git add test
$ git commit "fix conflict"
$ git push origin master

git rebase を使う場合

ローカル → リモートへの push で衝突発生。リモートの方が最新であるため、ローカルで pull せずに push してしまった状況です。

$ git push origin master
root@172.17.0.120's password:
To ssh://172.17.0.120/var/www/html/git/test.git
 ! [rejected]        master -> master (fetch first)
error: failed to push some refs to 'ssh://root@172.17.0.120/var/www/html/git/test.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

git hook

git commit や push をトリガーにリモートリポジトリサーバでスクリプトを実行します。下記は例として git push されたら、リモートリポジトリサーバで git pull を実行します。 template の設定は行わなくても構いません。

テンプレートディレクトリの作成(リモートサーバ)

$ cd GIT_DIR
$ git config --global init.templatedir /var/www/html/test.git/hooks
$ git config --global -l
$ vi hooks/post-receive
#!/bin/bash
cd /root/work/test
git --git-dir=.git pull

git push(クライアント)

$ git add <FILE>
$ git commit -m "add date"
$ git push origin master
Counting objects: 4, done.
Writing objects: 100% (3/3), 270 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: From ssh://localhost/var/www/html/test
remote:    1b2d49c..b7c3592  master     -> origin/master
remote: Updating 1b2d49c..b7c3592
remote: Fast-forward
remote:  date | 1 +
remote:  1 file changed, 1 insertion(+)
remote:  create mode 100644 date
To ssh://root@192.168.189.130/var/www/html/test.git
   1b2d49c..b7c3592  master -> master

##設定

基本的な設定

$ cd GIT_DIR
$ git config user.name XXX
$ git config user.email XXX

$ git config --system 全ユーザの全リポジトリに反映
$ git config --global ログイン中ユーザの全リポジトリに反映

設定値確認 $ git config -l

リモートリポジトリを追加

$ git remote -v #現在の設定値を確認
$ git remote add ssh://root@192.168.0.1/var/www/html/test.git

Files

git.md

Latest commit

History

git.md

File metadata and controls

git メモ

利用事例

仕組の概要

用語

ワークツリー

インデックス

リポジトリ

ブランチ

HEAD

コミット

プッシュ

プル

マージ

環境準備

利用方法

リモート git リポジトリのプレイブックをまとめてローカル PC にダウンロード

ローカル PC で書いたコードを ansible サーバにアップロードする

リモート git リポジトリの変更点をダウンロードする

強制的に pull する

ローカル PC のファイル状態を確認

特定ファイルの過去の状態を確認

git add したファイルを取り消す

git commit の打ち消し

git commit の取り消し

ブランチ関連

ブランチの変更

ローカルで削除したファイルをリストア

作業中の状態を一時保存する

特定のファイルを git 管理から除外したい場合

git 管理対象から削除したいとき

リモートリポジトリ関連

ログ関連

マージの衝突を解消する

git merge を使う場合

ローカルブランチで衝突発生。

修正前

修正後

コミット

push 時に衝突発生

git rebase を使う場合

git hook