開発中のソースコードの版(バージョン)を蓄えているものをリポジトリという。コミット(保存する操作)された版が全て記録されている。 gitでは、版管理の対象はプログラムソースコードに限らず、ファイルであれば何でも良いが、 バイナリファイルでファイルサイズが大きいものはやめたほうがよい。
通常のディレクトリのように、開発中のソースコードを置いてあるディレクトリのことを作業ディレクトリという。 gitで版管理されている場合、この作業ディレクトリには ".git"というディレクトリがあり(リポジトリの本体)、 版管理に関する情報や全ての版の記録が保存されている。
作業ディレクトリ内のファイルは、gitの版管理を意識せずに普通に修正等して構わない。
ログインしてシェルのプロンプトが出ており、カレントディレクトリが、版管理されている作業ディレクトリであるとする。 ここにあるリポジトリのことをローカルリポジトリと呼ぶ(単にリポジトリとも呼ばれる)。
目の前のPCにログインして、sshでリモートホストにログインして、カレントディレクトリが作業ディレクトリである場合でも、 そこにあるリポジトリはローカルリポジトリである。 (リモートログインしているけどローカルリポジトリです。 つまり、プロンプトが出ているところがローカルリポジトリということ。)
ローカルリポジトリは、他の"上流"にあるリポジトリと結びついている場合がある(その場合が大多数)。 この上流のリポジトリのことを、リモートリポジトリと呼ぶ(これも単にリポジトリとも呼ばれたりする)。
作業ディレクトリを持たないリポジトリ(".git"ディレクトリのみから成るようなもの)。 リモートリポジトリはふつうはベアリポジトリである。
作業ディレクトリ上で、 (1) ファイルを新規作成したり、修正して新しい版を作る。 (2) そのファイルをステージに載せる(ステージに登録、ステージングなどとも言われる。ステージのことを インデックスやキャッシュとも言われる)。 (3) コミット(commit)する。これでステージングされたファイルがリポジトリに記録され、半永久的に保存される。
以下では、ファイル名、ディレクトリ名、注釈などはすべて英語とする(トラブル回避のため日本語の使用を避ける)。
$ git config --global user.name "名前" $ git config --global user.email "メールアドレス" $ git config --global core.editor emacs $ git config --global push.default simple
版管理したい作業ディレクトリに移動して、初期化する。作業ディレクトリは空でも、ファイルがあっても構わない。
$ 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
さらに、マシン Cからもベアリポジトリを利用する場合
$ git clone ベアリポジトリのURL 作業ディレクトリ名
なお、ディレクトリが異なれば、マシン A, B, Cは同じPCであっても構わない。
$ git clone ベアリポジトリのURL 作業ディレクトリ名
$ git add ファイル #ファイル(ディレクトリも指定が可能)をステージングする。 #初めてaddされたファイルであれば、自動的にgitで版管理する追跡対象になる。 $ git commit -m "注釈" #ステージングされたファイルをローカルリポジトリにコミットする。 #注釈は英語で!
$ git push
$ git fetch #取り込むだけ $ git pull #取り込んで、作業ディレクトリのファイルにマージ(更新をファイルに適用)する
$ git checkout -b ブランチ名 #ブランチを作成し、作成したブランチに切り替える
$ git checkout ブランチ名 #既存のブランチに切り替える(未コミットなどがあればできない)
$ 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 #すべてのタグを表示
$ git merge origin/master
git fetch --all --tags
git tag tmp_hoge a5f38c9 #ローカルリポジトリでタグを付ける git push --tags #ローカルリポジトリにあるタグをすべてpushする
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
git rev-parse --short HEAD #HEADの7桁のSHA1を表示
git help rev-parse
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内)
作成中のプログラムがあるディレクトリ ~/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
cd ~/prac git init git add *.c *.h #メタキャラが使える git add makefile git add 他にもあれば追加 git commit -m "the first commit" #SPCが含まれるのでクォートした
emacs main.c 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
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
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はこのあと使わないので削除して構わない。
#ref(): File not found: "repository20211127.jpg" at page "howto/git/forthefirsttime"
ブラウザからダウンロード 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などで、練習1のディレクトリに移動する。 最初の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/