GitSetup の履歴(No.44)

基本
前提
設定
運用
git 環境変数の設定
git 公式サイトマニュアル（日本語）
逆引き git

基本†

３段構成（repo － index － working_tree)
index に git add で登録することを staging すると呼び
working_tree の親になっている commit を HEAD と呼ぶ

git diff は通常は working_tree と index の差分

↑

前提†

シングルユーザー、マルチユース
- ssh により多拠点リモートユース
- 複数のマシンで、別々の場所からから接続する
- gitweb を利用する
文書ファイル（tex など）の来歴管理を行なう
サーバー設定情報の管理も行なう
基本的に ubuntu の標準に従う（ファイルの置き場所など）

↑

設定†

server account
- user = git
- pass = gituser
- home = /mnt/raid_vol/home/git
- shell = /usr/bin/git-shell (git 操作専用、通常ログインはできない)
リモートリポジトリ＝ ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos 下

公開鍵がサーバーに登録されている場合＝ git clone ssh://MYTHEN/mnt/raid_vol/home/git/repos/(repo_name)

クライアントの ~/.ssh/config 設定

munakata@muna-E420:~/latex$ cat ~/.ssh/config
Host MYTHEN
	HostName		mythen.hmuna.com
	Port			8823
	IdentityFile	        ~/.ssh/muna_E420
	User			git

gitweb URL ＝ wiki.hmuna.com/gitweb

↑

運用†

↑

ローカルリポジトリの作成†

git init
git add
git commit -am "comments"

↑

リモートリポジトリの作成†

git init --bare --shared

↑

ローカルの内容をリモートに反映†

git remote add [local_repo 名 (origin)] ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/REPO_NAME
git push [local_repo 名 (origin)] master

↑

ローカルに git を導入†

共通環境の設定

munakata@muna-E420:~/beamer/keio2012$ git config --global user.email public_mail@hmuna.com
munakata@muna-E420:~/beamer/keio2012$ git config --global user.name "hisao munakata"

git local repo の設定と、変更のローカルコミット

munakata@muna-E420:~/beamer/keio2012$ git init
Reinitialized existing Git repository in /home/munakata/beamer/keio2012/.git/

munakata@muna-E420:~/beamer/keio2012$ git add *

↑

ローカルとリモートの repo の関係付け（ git remote add ）†

git remote add [ローカルブランチ名]　[リモートブランチ]
- この場合、リモートブランチの同じ名前のブランチに紐付かれる
- なので、基本ローカルブランチ名を push 先のブランチ名に合わせるのが無難である
git remote add [ローカルブランチ名]　[リモートブランチ]:[リモード上のブランチ名]
- このように明示的にリモート側のブランチ名を指定することも可能である。
- が、繰り返しになるが、もしリモート側のブランチ名指定を忘れ、上書きしてはいけない同名のブランチがあると事故になるので注意

munakata@muna-E420:~/beamer/keio2012$ git remote add origin ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/XXX

↑

remote ブランチとの関係付けを確認（ git remote -v）†

[local] munakata:~/latex/LFS301-JP$ git remote -v
github	https://github.com/hmunak/LFS301-JP-local.git (fetch)
github	https://github.com/hmunak/LFS301-JP-local.git (push)
hmuna	ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/LFS301-JP (fetch)
hmuna	ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/LFS301-JP (push)
origin	ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/LFS301-JP (fetch)
origin	ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/git/repos/LFS301-JP (push)

↑

ブランチ名を指定してリモートブランチを取得（clone -b リモートブランチ名）†

− git clone -b ブランチ名 https://リポジトリのアドレス

↑

ブランチ名の確認（ git branch -a）†

何もオプションを付けないと、現在のブランチ名が表示される

-a を付加すると、全てのブランチ名が見える

[local] munakata:~/latex/LFS301-JP$ git branch
* main

[local] munakata:~/latex/LFS301-JP$ git branch -a
* main
  remotes/github/main
  remotes/hmuna/main
  remotes/hmuna/master
  remotes/origin/HEAD -> origin/master
  remotes/origin/master

↑

ローカルブランチ名の変更（ git branch -m ）†

git branch -m [変更後のブランチ名]
- 現在のブランチ名を変更
git branch -m [変更したいブランチ名] [変更後のブランチ名]
- 明示的の変更対象のブランチ名を指定することもできる

↑

ローカルブランチの削除（ git branch -d ）†

git branch -d [ブランチ名]

↑

リモートブランチの削除†

git push [ローカルブランチ]（空白）:[削除するリモートブランチ名]
- 空白を push することで、リモートブランチを削除する

↑

リモートブランチの最新状況（削除など）をローカル側に反映する†

git fetch --prune （git fetch -p）

↑

リモートブランチ名を変更した時の、ローカルブランチの対応付け†

git branch -m main japanese-wip
git fetch origin
git branch -u origin/japanese-wip japanese-wip
git remote set-head origin -a

↑

ローカルブランチ (=master) のトラッキング先を明示的に指定†

通常は git clone した時点で origin/master としてトラッキング先リポジトリーが設定されるが
git pull した時にトラッキング先のブランチが指定されていない...　と表示された場合には、以下で再設定できる
コンソールで git clone したコードを vscode 上の git view 経由で操作した場合にこの問題が発生した

git branch --set-upstream-to=origin/master master

以下のように [master] と [origin/master] が並んでいる状態ならトラッキング情報が正しく設定されている

↑

ローカルブランチがトラッキングブランチであるかどうか確認†

japanese-wip2 がリモート origin のローカルブランチ japanese のトラッキングブランチであるか
```
[local] munakata:~/latex/LFS301-JP$ git status -sb
## japanese-wip2...origin/japanese [ahead 2]
```

↑

ローカルがブランチが追跡しているリモートブランチの確認†

[local] munakata:~/latex/LFS301-JP$ git branch -vv
* japanese-wip2 09f7ec1 [origin/japanese: ahead 2] Mint Linux -> Linux Mint, fix missing correction

ブランチ名コミット番号 [追跡ブランチ名] コミットメッセージ

↑

追跡するリモートブランチの設定†

git push -u origin　[ブランチ名]

↑

インデックス、ワーキングツリー、 HEAD の関係の変化†

↑

detached HEAD†

HEAD がブランチではなく commit ID を直接指している状況（= ブランチが無い特殊な状況）

解決するには git branch でブランチを作ればよい

[local] munakata:~/latex/LFS301$ git branch
* (HEAD detached at 313786d)
  japanese
[local] munakata:~/latex/LFS301$ git branch master
[local] munakata:~/latex/LFS301$ git checkout master
M	Makefile
Switched to branch 'master'
[local] munakata:~/latex/LFS301$ git branch
  japanese
* master

↑

git add -p†

-p を付けると変更箇所ごとに commit の対象にするか確認してくれる。
沢山の変更をした時に、論理的に関連のないものを別の commit にする（← 非常に重要）のを助ける

↑

git commit†

一行目に変更の概略 → パッチを送る時のメールタイトルになる。
二行目は空行
三行目以降に詳細な説明を書く

↑

git commit ＜path＞†

git commit に引数でファイル名を渡すと、明示的に指定されたファイルだけがcommit 対象になる

↑

git rebase -i で過去数回分のコミットをまとめる†

git rebase -i HEAD~~~~ (~ の数のコミットをまとめる）
git rebase -i HEAD~4

pick 29e1651 evaluate model updated, still in struggle
pick 35d15a4 temporaly save (no major change)
pick 356c295 removed unused view (preffered flag)
pick b81062d removed build-in command (vman_entry.py)

# Rebase ca395bd..b81062d onto ca395bd (4 commands)
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
# d, drop = remove commit
#

pick を s (squash) に書き換えるとコミットが前のコミットにマージされる

↑

git diff と git diff HEAD と git diff --cached の違い†

以下の図は murankの日記というサイトから引用

git diff は working_tree と index の差（git add 後に加えた差分が表示される）

git diff --cached は index と最新の commit の差

git diff HEAD は working_tree と最新の commit との差（git add したが commit していないものが含まれる）

git diff HEAD~..HEAD は複数のコミット間の差

↑

git diff --stat†

ファイル単位で変更（削除、追加）の量を概算表示する（パッチの素性を確認する等に使う）

[local] munakata:~/source/perl/nana2tex$ git diff eada 8435 --stat
 Makefile    |  6 ++++--
 nana2tex.pl | 78 +++++++++++++++++++++++++++++++-----------------------------------------------
 2 files changed, 35 insertions(+), 49 deletions(-)

↑

git reset†

HEAD の位置を変更するコマンド。
オプション (影響度の小さい順に --soft、--mixed(オプションなしと同等)、--hard) によってインデックス、ワーキングツリーの内容も変更できる。
- soft = HEAD の位置のみを変更する。インデックス、ワーキングツリーには影響なし。
- mixed (またはオプションなし) = HEAD の位置とインデックスを変更する。ワーキングツリーには影響なし。
- hard = HEADの位置、インデックス、ワーキングツリーをすべて変更する。

git reset --soft HEAD^

git reset HEAD

git reset HEAD^

git reset --hard

git reset --hard HEAD^

git reset --hard HEAD（HEAD^ ではなく）は最新の commit（=HEAD）以降のすべての working_tree の変更を取り消す

↑

git pull でコンフリクトした時の対応†

Your local change would be overwritten by merge. Commit, stash or revert to proceed と言われたら

git stash でローカルの変更を一時退避

git stash save -u
git stash list
git pull
git stash pop <------ 自動マージを試みる、コンフリクトしたら手修正
git drop <---- stash したファイルの削除

↑

ローカルの master を、強制的にリモートの master に合わせる†

// 1) リモートの最新を取ってきておいて・・
$ git fetch origin master

// 2) ローカルのmasterを、リモート追跡のmasterに強制的に合わせる！
$ git reset --hard origin/master

↑

git commit --amend : 直前のコミットのやり直し†

以下の操作と等価（一行で完結する）
- git reset HEAD^
- ファイルの再編集
- git add (file)
- git commit -a -m "新しいコミットメッセージ"
コミットメッセージの書き換えだけにも利用できる

↑

git reset <path>†

git reset　にファイル名を指定すると、明示的に指定されたファイルだけが

↑

git revert†

git revert は過去のコミットを取り消す

↑

git fetch†

git pull = git fetch + git merge
fetch はローカルマシン上のオリジン情報（= origin/master) を更新する。が、ソースは変更しない

↑

git log†

git log --pretty=oneline : 一行で表示オプション出力される内容

git log --pretty=format: (option) で色々な表示にできる

git log --pretty=format:"%h - %an, %ar : %s"
ca82a6d - Scott Chacon, 11 months ago : changed the version number
085bb3b - Scott Chacon, 11 months ago : removed unnecessary test code
a11bef0 - Scott Chacon, 11 months ago : first commit

format の書き方

%H	コミットのハッシュ
%h	コミットのハッシュ (短縮版)
%T	ツリーのハッシュ
%t	ツリーのハッシュ (短縮版)
%P	親のハッシュ
%p	親のハッシュ (短縮版)
%an	Author の名前
%ae	Author のメールアドレス
%ad	Author の日付 (--date= オプションに従った形式)
%ar	Author の相対日付
%cn	Committer の名前
%ce	Committer のメールアドレス
%cd	Committer の日付
%cr	Committer の相対日付
%s	件名

↑

git log でサマリーを表示させるスクリプト（gitlog）†

alias gitlog='git log --pretty="%h %ad: %s" --date=short'

↑

git push ローカル上の変更をリモートに反映†

munakata@muna-E420:~/beamer/keio2012$ git push e420 master
munakata@mythen.hmuna.com's password: 
Counting objects: 5, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 337 bytes, done.
Total 3 (delta 2), reused 0 (delta 0)
To ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/munakata/repos/keio2012
   462fe87..7a936a0  master -> master

↑

既にあるブランチへの切り替え†

git checkout ブランチ名

↑

git ブランチを作成して、そのブランチに移動†

git checkout -b ブランチ名

これは以下の２つをまとめて実行したことになる

git branch ブランチ名
git checkout ブランチ名

↑

git ブランチをプッシュ†

git push origin [branch 名]

↑

git ブランチの削除†

git branch -d ブランチ名

↑

git の管理対象から外す†

.git と同じディレクトリーに .gitignore というファイルを作成し追跡させないファイルの拡張子やディレクトリを列挙する。
git はリカーシブに検索するのでファイル拡張子を指定する場合にディレクトリー名を指定する必要はない
注意：一度 git の追跡対象となったファイルは .gitignore に定義しても管理対象外にならない。次項のキャッシュの削除が必要

↑

git の管理対象から外す２（.gitignore に追加登録する場合には必須）†

特定のファイルを対象外にする場合
```
git rm --cached [ファイル名]
```
一括してキャッシュを削除する場合
```
git rm -r --cached .
```

↑

git gc†

レポジトリの最適化（未使用オブジェクトの削除、圧縮）

↑

過去のリビジョンからファイルを復元 (abc123リビジョンにあるhoge.txtを持ってきたいとする)†

git checkout -f abc123 hoge.txt

↑

git tag †

git tag -a <タグ名> -m "メッセージ"
git push --tags

git checkout -b 1.6 refs/tags/v1.6 (tag を指定してブランチにチェックアウト)

↑

tag を削除 (付け直す)†

git tag -d TAG_NAME (まずローカルのタグを削除)
git push origin :refs/tags/TAG_NAME (リモートのタグを空のタグで上書きする形で削除)

↑

git diff†

git diff --word-diff=color
- 単語ベースのdiff
- 行の中の一部だけが変更されてるのをみたりするのに便利
- color を指定すると色の変化でdiffがわかって良い

git diff --ignore-space-at-eol
- 末尾空白の変更を無視する
- なんかのついでに末尾スペース削りまくってるみたいな変更に対して便利

git diff -b
- 空白の変更を無視する
- このへん多分インデントかわっただけだよね.. て心配なときに確認するのに便利

↑

git send-email†

apt-get install git-email
git format-patch HEAD^ (file_name)
git send-email (file_name)

↑

日本語のファイル名などを表示させる†

git config --global core.quotepath false

git document

core.quotePath
Commands that output paths (e.g. ls-files, diff), will quote "unusual" characters in the pathname
by enclosing the pathname in double-quotes and escaping those characters with backslashes in the
same way C escapes control characters (e.g. \t for TAB, \n for LF, \\ for backslash) or bytes
with values larger than 0x80 (e.g. octal \302\265 for "micro" in UTF-8). If this variable is set
to false, bytes higher than 0x80 are not considered "unusual" any more. Double-quotes, backslash
and control characters are always escaped regardless of the setting of this variable.
A simple space character is not considered "unusual". Many commands can output pathnames completely
verbatim using the -z option. The default value is true.

↑

git credential helperを使って HTTP越しで認証がかかっているリポジトリにアクセスする †

HTTP は基本的に読み込み専用のリポジトリーに使う。以下の方法は ssh 接続では使えない
git config --global credential.helper store
cloneが終わると、$HOME/.git-credentialsというファイルが生成される。
中身はリポジトリホスト名とユーザ名・パスワードが平文で保存されている。
git config --global credential.helper cache

↑

SSH 接続でパスワードなしにするには公開鍵をサーバーに登録する †

クライントで ssh-keygen を実行、パスフレーズは無しで生成する。 − サーバーの ~/.ssh に
```
cat （クライアントの公開鍵）>> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
```

クライアントの ~/.ssh/config に

munakata@muna-E420:~/latex$ cat ~/.ssh/config
Host MYTHEN
	HostName		mythen.hmuna.com
	Port			8823
	IdentityFile	        ~/.ssh/muna_E420 (公開鍵)
	User			munakata

クライアントのシェルに鍵を登録

$ ssh-agent bash
$ ssh-add ~/.ssh/(秘密鍵)

注：gitサーバーの .ssh のディレクトリーのパーミションが 700 でないと、git push 時に git ユーザーのパスワードを聞かれる（が、git アカウントには対話ログインを許可していないので正しいパスワードを入れても push できない。）

↑

git 環境変数の設定 †

munakata@mythen:~/My_presentations/als2013JP$ git config -l
color.ui=auto
user.name=hisao munakata
user.email=public_mail@hmuna.com
core.quotepath=false
core.repositoryformatversion=0
core.filemode=true
core.bare=false
core.logallrefupdates=true
remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
remote.origin.url=ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/munakata/repos/als2013JP
branch.master.remote=origin
branch.master.merge=refs/heads/master
remote.mythen.url=ssh://munakata@mythen.hmuna.com:8823/mnt/raid_vol/home/munakata/repos/als2013JP
remote.mythen.fetch=+refs/heads/*:refs/remotes/mythen/*

↑

git 公式サイトマニュアル（日本語）†

↑