howto/git/forthefirsttime †

↑

一行メモ †


↑

マニュアル・リンクなど †

↑

はじめてのGit †

git（ギット）はソフトウェアなどのバージョン管理をするツールである。

↑

予備知識 †

↑

リポジトリ †

開発中のソースコードの版（バージョン）を蓄えているものをリポジトリという。コミット（保存する操作）された版が全て記録されている。 gitでは、版管理の対象はプログラムソースコードに限らず、ファイルであれば何でも良いが、 ファイルサイズが大きいものは動作が重くなるためやめたほうがよい。

↑

作業ディレクトリ †

通常のディレクトリのように、開発中のソースコードを置いてあるディレクトリのことを作業ディレクトリという。 これをgitで版管理している場合、この作業ディレクトリには ".git"というディレクトリがあり（リポジトリの本体）、 版管理に関する情報や全ての版が保存されている。

作業ディレクトリ内のファイルは、gitの版管理を意識せずに普通に修正等して構わない。

↑

ローカルリポジトリ †

ログインしてシェルのプロンプトが出ており、カレントディレクトリが、版管理されている作業ディレクトリであるとする。 ここにあるリポジトリのことをローカルリポジトリと呼ぶ（単にリポジトリとも呼ばれる）。

開発作業はすべてローカルリポジトリがある作業ディレクトリで行います。

↑

リモートリポジトリ †

ローカルリポジトリは、他の"上流"にあるリポジトリと結びついている場合がある（その場合が大多数）。 この上流のリポジトリのことを、リモートリポジトリと呼ぶ（これも単にリポジトリとも呼ばれたりする）。 上流は版のデータを受け渡しすることに使われる。

↑

ベアリポジトリ †

作業ディレクトリを持たないリポジトリ（".git"ディレクトリのみから成るようなもの）。 リモートリポジトリはふつうはベアリポジトリである。
上流のリポジトリのポンチ絵

nowrap
↑

新しい版のコミットまでの流れ †

作業ディレクトリ上で、 (1) ファイルを新規作成したり、修正する。 (2) そのファイルをステージに載せる（ステージに登録、ステージングなどとも言われる。ステージのことを インデックスやキャッシュとも言われる）。 (3) コミット（commit）する。これでステージングされたファイルがリポジトリに記録され、半永久的に保存される。

ローカルリポジトリの内容をリモートリポジトリに送る(pushと呼ぶ)ことで、自分の作業内容を他の人が利用できるようになる。 逆に他の人の作業内容を取り込むこともできる(pullと呼ぶ)。 自分ひとりだけで複数のローカルリポジトリを開発に利用することもできる。

↑

もっと予備知識 †

↑

基本的な操作（リポジトリの作成） †

以下では、ファイル名、ディレクトリ名、注釈などはすべて英語とする（トラブル回避のため日本語の使用を避ける）。

↑

最初に一度だけする設定（マシン毎） †

 $ git config --global user.name     "名前"
 $ git config --global user.email    "メールアドレス"
 $ git config --global core.editor   emacs
 $ git config --global push.default  simple
↑

新規に、ローカルリポジトリを作る †

版管理したい作業ディレクトリに移動して、初期化する（.gitディレクトリを作る）。作業ディレクトリは空でも、ファイルがあっても構わない。

$ cd 作業ディレクトリ
$ git init
↑

新規に、リモートリポジトリ（ベアリポジトリ）を作って、利用する †

マシン Aにベアリポジトリを作って、マシン Bにローカルリポジトリを作って利用する場合

マシン Aで
$ mkdir ベアリポジトリのディレクトリ名.git
$ cd ベアリポジトリのディレクトリ名.git      #(*)
$ git init --bare

マシン Bで
$ cd 作業ディレクトリ
$ git init
$ git remote add origin  ベアリポジトリのURL
                 #URLは上の(*)を示す「ssh://xxx@yyy:/～/ベアリポジトリのディレクトリ名.git」などを指定
$ git push --set-upstream origin master

なお、ディレクトリが異なれば、マシン A, Bは同じPCであっても構わない。

↑

既存のリモートリポジトリのコピー（クローン）をしてローカルリポジトリを作る †

$ git clone ベアリポジトリのURL  作業ディレクトリ名
↑

基本的な操作（日々の作業など） †

↑

ファイルをステージングし、ローカルリポジトリにコミットする †

  $ git add ファイル  #ファイル（ディレクトリも指定が可能）をステージングする。
                      #初めてaddされたファイルであれば、自動的にgitで版管理する追跡対象になる。
 
  $ git commit -m "注釈"  #ステージングされたファイルをローカルリポジトリにコミットする。
                          #注釈は英語で！
↑

ローカルリポジトリの更新内容をリモートリポジトリに送る †

  $ git push
↑

リモートリポジトリの更新内容を作業ディレクトリに取り込む †

  $ git fetch  #取り込むだけ
  $ git pull   #取り込んで、作業ディレクトリのファイルにマージ（更新をファイルに適用）する
↑

新しくローカルリポジトリにブランチを作る †

  $ git checkout -b ブランチ名  #ブランチを作成し、作成したブランチに切り替える
↑

既存の別のブランチに切り替える †

  $ git checkout ブランチ名     #既存のブランチに切り替える（未コミットなどがあればできない）
↑

新しくローカルリポジトリにブランチを作り、リモートリポジトリにpushする †

  $ git checkout -b ブランチ名  #ブランチを作成し、作成したブランチに切り替える
  $ git push --set-upstream  origin ブランチ名
      #リモートリポジトリoriginにブランチをpushする（ブランチが作成される）とともに、ローカルリポジトリのブランチが
      #originに作成されたブランチを追跡するように設定する（--set-upstream）。
↑

リモートリポジトリにあるブランチを追跡するように、ローカルリポジトリに同名のブランチを作成し、作成したブランチに切り替える †

  $ git checkout --track origin/ブランチ名
↑

更新内容の表示など †

  $ git fetch                       #リモートリポジトリの更新内容を読み込む
  $ git remote -v ; git branch -vv  #リモートリポジトリを表示；ブランチを表示
  $ git status                      #作業ディレクトリの状態を表示
  $ git log -15 --oneline --decorate --graph --all  #コミットログを表示, スクロールなどの操作はviとほぼ同じ
  $ gitk --all                                      #コミットログを表示（GUIによる）

  $ git branch -a    #すべてのブランチを表示
  $ git tag          #すべてのタグを表示
↑

基本的な操作（複数のブランチ利用） †

↑

あるSHA1のコミットにタグを付ける †

git tag tmp_hoge a5f38c9  #ローカルリポジトリでタグを付ける
↑

ブランチを削除する †

git branch -d    hogehoge          #ローカルリポジトリにあるブランチhogehogeを削除
git branch -d -r origin/hogehoge   #ローカルリポジトリにあるブランチorigin/hogehogeを削除
git push origin --delete hogehoge  #リモートリポジトリのブランチhogehogeを削除
↑

差分をみる †

git diff --cached   #親コミットとステージの差分
git diff master_20190603 HEAD nameless_pot.c   #master_20190603タグと親コミットとの差分をnameless_pot.cについて表示
↑

helpコマンド †

git help rev-parse
↑

masterをマージする †

git merge --no-commit --no-ff master
  #dry-run的なことがされるので確認後、マージをアボートか、コミットする
  #git merge --abort
  #git commit -m "merge branch master into hogehoge"
↑

作業ディレクトリのファイルのうち、追跡対象になっていないファイルを確認 †

git ls-files -o --exclude-standard
gitlsfiles.py  #python3環境のみ(~okazaki/util/com内)
↑

練習 †

マシンivyに作成中のプログラムがあるディレクトリ ~/pracがあるとする。

↑

最初に一度だけする設定をせよ †

git config --global user.name     'john smith' #SPCが含まれるのでクォートした
git config --global user.email    smith@ivy    #適当でよい
git config --global core.editor   emacs
git config --global push.default  simple

git config -l  #設定内容の確認
↑

pracディレクトリを版管理するために、ローカルリポジトリを作成し、必要なファイルをステージングし、コミットせよ †

cd ~/prac
git init
gitk --all &  #以下のコマンド実行前後で、gitkのメニューからupdateして表示内容がどう変わるかを確認する。
              #また git status も実行し、表示内容がどう変わるかも確認する。
git add *.c  #メタキャラが使える。各自、自分の状況に合わせてファイルをaddする
git add *.h
git add makefile
git add 他にもあれば追加  #大きなファイルは追加しない
git commit -m "the first commit"   #SPCが含まれるのでクォートした
gcc -o main.x main.c
./main.x

（注）gitkコマンドはXウィンドウシステムを介してGUIウィンドウを表示する。sshログインしたマシンで実行したプログラムの GUIウィンドウを表示するには、sshコマンドに -Y オプションを与えておく必要がある（ssh yourname@hostname -Y）。 もしくは DISPLAY環境変数を設定する必要がある。

↑

修正してコミットせよ（１回以上）。以下のよく使うコマンドも試せ †

emacs main.c    #コメントを入れるとか、空行を使いするとかでよい
gcc -o main.x main.c
./main.x
git add main.c
git commit -m "modify main.c"
作業ディレクトリの状態を確認するときによく使うコマンド、適当なタイミングで、必要に応じて試せ。
git remote -v ; git branch -vv    #ブランチを表示
git status                        #作業ディレクトリの状態を表示
git log -15 --oneline --decorate --graph --all  #コミット履歴を表示
gitk --all
git diff            #作業ディレクトリと親コミットとの差分表示
git diff --cached   #ステージと親コミットとの差分表示
↑

.gitignoreファイルを作り、不要な出力を抑止する †

作業ディレクトリに追跡対象ではないファイルがあると git statusで出力される。 出力させたくない場合、.gitignoreファイルにファイル名を記載する。

emacs .gitignore
*~   #例えば、この2行を
*.x  #.gitignoreに記載する。
git add .gitignore
git commit -m "add .gitignore"
↑

ベアリポジトリを作り、pushしてみよ †

cd ~
mkdir repgit;   cd repgit
mkdir prac.git; cd prac.git
git init --bare
#~/repgitディレクトリの中に prac.gitというベアリポジトリを作った。
cd ~/prac
git remote add origin  ssh://yourname@hostname:/home/yourname/repgit/prac.git
    #originに URLを登録
git push --set-upstream origin master
    #originのmasterブランチにpushするとともに、
    #ローカルリポジトリのカレントブランチ（masterブランチ）が originのmasterを追跡するように設定
#yournameはログインID
#hostnameはivy.eit.hirosaki-u.ac.jpなど
↑

ベアリポジトリからクローンしてみよ †

cd ~
mkdir tmp; cd tmp
git clone ssh://yourname@hostname:/home/yourname/repgit/prac.git prac2
↑

クローンしたリポジトリの作業ディレクトリで、ファイルを修正してcommit, pushし、もともとの作業ディレクトリでpullしてみよ †

cd ~/tmp/prac2
emacs main.c
git add main.c
git commit -m "modify main.c in prac2"
git push
cd ~/prac
git fetch
git pull
prac2とpracで更新内容などを見てみよ
git remote -v ; git branch -vv
git log -15 --oneline --decorate --graph --all
~/tmp/prac2はこのあと使わないので削除して構わない。
↑

ソースからgitをインストールする例 †

ブラウザからダウンロード https://github.com/git/git/archive/master.zip
$ unzip git-master.zip
$ cd git-master
$ autoconf
$ ./configure --prefix=$HOME/bin
$ make all      # doc info はめんどいらしいので除く
$ make install  # install-doc install-html install-info は除く
# バージョンは、2.2.0.GITだった。
| git-master/INSTALLには次のように記載あり
| $ make prefix=$HOME/bin all doc info
| $ make prefix=$HOME/bin install install-doc install-html install-info

ブラウザからダウンロード https://www.kernel.org/pub/software/scm/git/ の git-manpages-2.2.0.tar.gz
$ tar xvfz git-manpages-2.2.0.tar.gz  -C $HOME/bin/share/man  # man{1,5,7}に追加される
MANPATH=$HOME/bin/share/man:$MANPATH を .bashrcに追加する

(補足) zlibが無かった場合には makeできないので、下のようにzlibをインストール後に、
再度 git-masterディレクトリで ./configure --prefix=$HOME/bin --with-zlib=$HOME/bin
としてから makeする。
  $ wget http://zlib.net/zlib-1.2.8.tar.gz
  $ md5sum zlib-1.2.8.tar.gz
  $ tar xvfz zlib-1.2.8.tar.gz
  $ cd zlib-1.2.8
  $ ./configure --prefix=$HOME/bin
  $ make
  $ make install
↑

練習（しなくてもよい） †

↑

練習１ †

ivy.eit.hirosaki-u.ac.jpにログインして、"最初に一度だけする設定"をする。

次に、適当なディレクトリで、

$ git clone git://git.kernel.org/pub/scm/git/git.git #作業ディレクトリ名を省略した
$ cd git
$ git remote -v
$ git branch -vv
$ git status
$ git log  --oneline --decorate --graph --all
   一画面下にスクロール SPC
   一画面上にスクロール w
   一行上にスクロール   j
   一行下にスクロール   k
   下に検索             /    ⇒ origin/masterという文字列を検索してみる
   上に検索             ?
   次のもの検索         n
   一番下を表示         ESC >
   一番上を表示         ESC <
   終了 q

$ DISPLAY=hogehoge:0 gitk --all    # ssh -Yでログインしている場合、DISPLAY環境変数の設定は不要。
$ DISPLAY=hogehoge:0 gitk          # hogehogeはウィンドウを表示させるホストのホスト名にする。
$ DISPLAY=hogehoge:0 gitk --all &
$ git log   --oneline --decorate --graph --all | tail
$ git checkout -b mytest e83c51633
$ git help checkout
$ git status
$ git log   --oneline --decorate --graph --all | tail
$ make  #失敗するので、
Makefileの
  LIBS= -lssl
を
  LIBS= -lssl -lcrypto -lz
に変更して、再度makeする
$
$ git status
$ git add -u
$ git status
$ git commit -m "modify Makefile"
$ git status
$ git branch -vv
$ git log   --oneline --decorate --graph --all | head ; echo ... ; \
  git log  --oneline --decorate --graph --all | tail
また、gitkのメニューから更新を選んで、ログを確認して、終了q。
↑

練習２（１のつづき） †

$ mkdir ../hoge; cd../hoge  #適当なディレクトリを作り、移動する
$ cp../git/{*.[ch],Makefile,README} .
$ ls
Makefile  cache.h    commit-tree.c  read-cache.c  show-diff.c     write-tree.c
README    cat-file.c init-db.c      read-tree.c   update-cache.c
$ git init
$ git add *.[ch] Makefile README
$ git status
$ git commit -m "the first commit"
$ git log   --oneline --decorate --graph --all
$ git remote -v ; git branch-vv

たとえば、emacsでMakefileをオリジナルのもの（LIBS= -lssl）に戻す。
$ git diff
$ git add Makefile
$ git commit -m "make Makefile the original"
$ git log   --oneline --decorate --graph --all
$ git checkout -b testb
$ git branch -vv
emacsで MakefileのLIBSを -lssl -lcrypto -lz にする。
$ git add Makefile
$ git commit -m "modify Makefile"
$ git log   --oneline --decorate --graph --all
$ git branch -vv
$ git checkout master
$ git branch -vv
emacsで MakefileのLIBSを -lssl -lcrypto にする。
$ git add Makefile
$ git commit -m "modify Makefile, again"
$ git log   --oneline --decorate --graph --all
↑

遊び（練習１のつづき） †

cd ../gitなどで、練習１のディレクトリに移動する。
最初のgitを動かしてみる。そのままでは実行時にエラーになるようなので、
read-cache.cの228行目付近のif文をコメントアウトして、makeし直す。
-               if (size > sizeof(structcache_header))
+//             if (size > sizeof(structcache_header))
                        map = mmap(NULL, size,PROT_READ, MAP_PRIVATE, fd, 0);
$ ./init-db  # .dircacheディレクトリが作成される（.git相当）
$ ./update-cache *.[ch] Makefile README  #update-cacheが git add相当
$ ./write-tree                           #write-tree,commit-treeが git commit相当
6ca44177a19e6ca8f2f761b7415a4360d2db6b8e
$ ./commit-tree 6ca44177a19e6ca8f2f761b7415a4360d2db6b8e <<eof
the first commit
eof
Committing initial tree 6ca44177a19e6ca8f2f761b7415a4360d2db6b8e
bab38708b02450867071a94a9fce18123597835d
$ cat `./cat-file bab38708b02450867071a94a9fce18123597835d | sed 's/:.*$//'` #コミットの表示
tree6ca44177a19e6ca8f2f761b7415a4360d2db6b8e
author okazaki,isao,,<okazaki@ivy> Fri Jun 23 14:41:39 2017
committer okazaki,isao,,<okazaki@ivy> Fri Jun 23 14:41:39 2017

the first commit

$ ./read-tree 6ca44177a19e6ca8f2f761b7415a4360d2db6b8e #コミットの内容（ツリー）
100664 Makefile(dfa152bcc0e5f29d5a2db9a482d7e65660a6fe61)
100664 README (665025b11ce8fb16fadb7daebf77cb54a2ae39a1)
100664 cache.h(9e1bee21e17c134a2fb008db62679048fc819528)
100664 cat-file.c(fd690acc02ef9c06d7c4c3541f69b10ca4b4f8c9)
100664 commit-tree.c(a4a8c3d9ef0c4cc6c82b96b5d1a91ac6d3bed466)
100664 init-db.c(0eaa053919e0cc400ab9bc40d9272360117e6978)
100664 read-cache.c(4d3c01ab27d6745be53d5caf862e5ce4d939961c)
100664 read-tree.c(ec0f167a6a505659e5af6911c97f465506534c34)
100664 show-diff.c(00a29c403e751c2a2a61eb24fa2249c8956d1c80)
100664 update-cache.c(aff074c63ac827801a7d02ff92781365957f1430)
100664 write-tree.c(7abeeba116b2b251c12ae32c7b38cb048199b574)
$ ./show-diff
Makefile: ok
README: ok
cache.h: ok
cat-file.c: ok
commit-tree.c: ok
init-db.c: ok
read-cache.c: ok
read-tree.c: ok
show-diff.c: ok
update-cache.c: ok
write-tree.c: ok

次に、emacsでread-cache.cの228行目付近にfprintfを追加（追加内容は以下のdiff参照）。
$ ./show-diff
Makefile: ok
README: ok
cache.h: ok
cat-file.c: ok
commit-tree.c: ok
init-db.c: ok
read-cache.c:  4d3c01ab27d6745be53d5caf862e5ce4d939961c

--- -   2017-06-23 14:54:17.547672847 +0900
+++ read-cache.c        2017-06-23 14:53:00.644494732 +0900
@@ -228,6 +228,8 @@
                map = NULL;
                size = st.st_size;
                errno = EINVAL;
+fprintf( stderr, "size= %d\n", size );
+fprintf( stderr,"sizeof = %d\n", sizeof(struct cache_header) );
 //            if (size > sizeof(struct cache_header))
                        map = mmap(NULL, size,PROT_READ, MAP_PRIVATE, fd, 0);
        }
read-tree.c: ok
show-diff.c: ok
update-cache.c: ok
write-tree.c: ok
$ ./update-cacheread-cache.c
$ ./write-tree
792883deac0a678d1975ddb4acce30ed15010149
$ ./commit-tree 792883deac0a678d1975ddb4acce30ed15010149 \
             -p bab38708b02450867071a94a9fce18123597835d <<eof
add fprintf
eof
8af70d35558e4226155fdad489654a0ece5ee196
$ cat `./cat-file 8af70d35558e4226155fdad489654a0ece5ee196 | sed 's/:.*$//'`
tree 792883deac0a678d1975ddb4acce30ed15010149
parent bab38708b02450867071a94a9fce18123597835d
author okazaki,isao,,<okazaki@ivy> Fri Jun 23 15:14:12 2017
committer okazaki,isao,,<okazaki@ivy> Fri Jun 23 15:14:12 2017

add fprintf

最初のコミットのツリー（6ca44177a19e6ca8f2f761b7415a4360d2db6b8e）の
read-cache.c（4d3c01ab27d6745be53d5caf862e5ce4d939961c）を取り出し、diffを
とってみる。

$ ./cat-file 4d3c01ab27d6745be53d5caf862e5ce4d939961c
temp_git_file_nV0xt4: blob
$ diff temp_git_file_nV0xt4read-cache.c
230a231,232
> fprintf( stderr,"size = %d\n", size );
> fprintf( stderr,"sizeof = %d\n", sizeof(struct cache_header) );

使い方は次を参考にすると良い。
 "git(1)の最初のコミットをビルドして使ってみた"http://qiita.com/gfx/items/826b5f846e6a960adcff
 "Gitの最初の姿"http://daretoku-unix.blogspot.jp/2015/03/git.html
 "初期のGitコマンドのソースコード"http://tanakahx.github.io/blog/2014/06/08/initial-git-source-code/
トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS