#navi_header|技術|

2013年になって、ようやくお仕事の都合もあり、Gitを使って見ることにしました。
Redmineとの連携も体験したかったので、ALMiniumをUbuntu上に展開し、そこにリモートリポジトリを作成して練習してみました。
ということで、その時の練習メモです。

#outline||

本家：
- Git
-- http://git-scm.com/
- Pro Git - Table of Contents
-- http://progit.org/book/
- GitHub
-- https://github.com/
- EGit (Eclipse用Gitプラグイン)
-- http://www.eclipse.org/egit/
- alminium/alminium
-- https://github.com/alminium/alminium/

勉強した時の参考資料：
- かんばん！～もし女子高生がRedmineで「スクラム」開発をしたら
-- http://www.atmarkit.co.jp/fjava/index/index_scrum.html
- サルでもわかるGit入門 〜バージョン管理を使いこなそう〜 | どこでもプロジェクト管理バックログ
-- http://www.backlog.jp/git-guide/
--- 「サルでもわかる〜」があれば本記事の使い方メモは読まなくてもOK。

#more||
* Gitの使い方メモ

各種参考資料からの抜き書き。（もしかしたら間違ってるかもしれないので注意）

** 初期設定

 $ git config --global user.name "FirstName FamilyName"
 $ git config --global user.email foo@example.com
 $ git config --global core.editor "/usr/bin/vim"

SSLの証明書検証を無視させる：社内LAN上のサーバを参照する場合など。
 $ git config --global http.sslverify false

** 日本語文字化け対策(Cygwin Git)

今回検証に使ったCygwin Gitのバージョン
 $ git --version
 git version 1.7.9

LANG環境変数
 $ echo $LANG
 ja_JP.UTF-8

"git diff"文字化け対策(?):
 $ export PAGER="lv"

コミットログ編集時文字化け対策:
 $ git config --global i18n.commitencoding UTF-8
 
"git status"文字化け対策:
 $ git config --global core.quotepath false

参考：
- SubversionからGitへ移行しようとして日本語ファイル名(UTF8)に困ったことある方に (ゆめ技：ゆめみスタッフブログ)
-- http://yumewaza.yumemi.co.jp/2010/08/git-svn-utf8-filename.html
- nashellog: Cygwin上のgit statusで文字化け
-- http://nashellog.blogspot.jp/2012/06/cygwingit-status.html
- cygwinのgitで日本語を文字化けさせない | Memorandum
-- http://www.pistolfly.jp/weblog/2009/12/cygwingit.html
- cygwinのgitで日本語を文字化けさせない - もうカツ丼でいいよな
-- http://d.hatena.ne.jp/Rion778/20091107/1257623615

** 基本的なファイル追加・名前変更・削除操作

"git add"をskipしてcommit
 $ git commit -a

"git add"したファイルを"Stage(Index)"から外したい
 $ git status -s
  M hello.txt
 $ git add hello.txt
 $ git status -s
 M  hello.txt
→これを戻す：
 $ git reset -- hello.txt
 Unstaged changes after reset:
 M       hello.txt
 $ git status -s
  M hello.txt
→さらに、hello.txtの変更も無効化して最後の状態に戻すには：
 $ git checkout -- hello.txt

1つ手前のコミット状態に戻したい

HEAD自体が参照しているリビジョンは動かさずに、Stage(Index)とWorking Directoryを巻き戻す：
 $ git checkout HEAD^
 $ git branch
 * (no branch)
   master

その後、調べ物が終わったので、masterのHEADに戻す：
 $ git checkout master

HEAD自体を巻き戻す：
 $ git reset HEAD^
→ただし、これだと"Stage(Index)"を1つ手前に戻した状態となる。HEADを移動させるには、リビジョンのID指定で"git reset"し直す必要がある。

ファイル名の変更
 $ git mv old new

ファイルの削除
 $ git rm file

** ファイル・ディレクトリを無視させる

基本は "man gitignore" 参照。

参考:
- gitで管理しないファイルを無視させる .gitignore｜misc｜@OMAKASE
-- http://www.omakase.org/misc/gitignore.html
- 既に git 管理しているファイルをあえて無視したい #git - Qiita
-- http://qiita.com/items/56d0d3ba7a1300625f92
--- IDEの設定ファイルなど、「最初の一回目以降の変更は無視させたい」場合に適用可能か。

** ブランチの作成と切り替え

*** その１：user1で新規ブランチ作成～pushまで
#pre||>
$ git checkout -b b2

... some modification ...

$ git commit -a

$ git push origin b2
Counting objects: 5, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 313 bytes, done.
Total 3 (delta 1), reused 0 (delta 0)
To http://shade1.glamenv-septzen.net/git/testproject1
 * [new branch]      b2 -> b2
||<

*** その２：user2で、新しくpushされたb2をpullして編集、pushするまで

#pre||>
$ git pull
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 1), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From http://shade1.glamenv-septzen.net/git/testproject1
 * [new branch]      b2         -> origin/b2
Already up-to-date.

$ git checkout b2

...

$ git commit -a

$ git push
Counting objects: 5, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 343 bytes, done.
Total 3 (delta 1), reused 0 (delta 0)
To http://shade1.glamenv-septzen.net/git/testproject1
   e90b0d3..bd9b8ae  b2 -> b2
||<

*** その３：user1で、user2がb2にpushした変更をpullして、masterにマージするまで

#pre||>
$ git branch
  b1
* b2
  master

$ git pull
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 1), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From http://shade1.glamenv-septzen.net/git/testproject1
   e90b0d3..bd9b8ae  b2         -> origin/b2
You asked me to pull without telling me which branch you
want to merge with, and 'branch.b2.merge' in
your configuration file does not tell me, either. Please
specify which branch you want to use on the command line and
try again (e.g. 'git pull <repository> <refspec>').
See git-pull(1) for details.

...(省略)...

See git-config(1) for details.

→怒られたので、originとブランチ名を指定してみる：
$ git pull origin b2
From http://shade1.glamenv-septzen.net/git/testproject1
 * branch            b2         -> FETCH_HEAD
Updating e90b0d3..bd9b8ae
Fast-forward
 hello2.txt |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)

→masterブランチにmergeして、pushする。
$ git checkout master
Switched to branch 'master'
$ git merge b2
Updating 8914003..bd9b8ae
Fast-forward
 hello2.txt |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)

$ git push
Total 0 (delta 0), reused 0 (delta 0)
To http://shade1.glamenv-septzen.net/git/testproject1
   8914003..bd9b8ae  master -> master
||<

*** その４：作業が終わったb2ブランチを削除する(未完)

#pre||>
最初にローカルから削除。
$ git branch -d b2
Deleted branch b2 (was bd9b8ae).

続いてリモートから削除。
$ git push origin :b2
remote: error: denying ref deletion for refs/heads/b2
→???
||<

ALMiniumとGitのアカウントの連携の設定が影響してるのか、リモートブランチ削除できない・・・。順番がおかしいのか？謎。

* GitHub関連

** HTTPSでPUSHしたりするとき、ユーザ名とパスワードを都度入力したくない

1.7.9 以上なら、時間を決めてキャッシュ出来るようになりました。専用のデーモンが裏で起動されてキャッシュしてくれるようです。
 $ git config --global credential.helper 'cache --timeout=3600'
 → 1時間キャッシュしてくれる。

古いバージョンだと、originサーバのURLにユーザ名・パスワードを仕込んでおいたり、"~/.netrc" に書いたりしてたようです。

参考：
- git - Is there a way to skip password typing when using https:// github - Stack Overflow
-- http://stackoverflow.com/questions/5343068/is-there-a-way-to-skip-password-typing-when-using-https-github
- Githubへのpushでusername/passwordを省略する方法２つ - Shoken OpenSource Society
-- http://shoken.hatenablog.com/entry/20120629/p1

** README.md のMarkDown

GitHub用に調整されたMarkDownになっているそうです。
- GitHub Flavored Markdown · github:help
-- https://help.github.com/articles/github-flavored-markdown

使いこなしガイド：
- 脱GitHub初心者を目指す人のREADMEマークダウン使いこなし術 | ゆっくりと…
-- http://tokkono.cute.coocan.jp/blog/slow/index.php/programming/markdown-skills-for-github-beginners/

オンラインでプレビューできるサービス：
- Github Preview
-- http://github-preview.herokuapp.com/

チートシート：
- Markdown Cheatsheet · adam-p/markdown-here Wiki
-- https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#wiki-code

* 参考資料

** Git Cheat Sheet

- Git Reference
-- http://gitref.org/index.html
--- Gitの主要コマンドの典型的な使い方が網羅されたリファレンス。個人的には、割りとわかりやすく感じました。
- A Visual Git Reference
-- http://marklodato.github.com/visual-git-guide/index-en.html
--- 各種操作における "Working Directory", "Stage(Index)", "History" を始めとする各データ要素間でのやりとりがわかりやすく図示されている。内部処理を理解する上で重要そう。
- Git Cheat Sheet 日本語版 | textdrop
-- http://www.textdrop.net/doc/git-cheat-sheet-ja/
--- 印刷して手元に置いておきたい。
- 見えないチカラ: 【翻訳】Gitをボトムアップから理解する
--- http://keijinsonyaban.blogspot.jp/2011/05/git.html
--- Gitの内部処理の理解。Gitって内部処理を理解したほうが回り道に見えるけど実は近道な気がします。

** Git Cheat Sheets それ自体のまとめ

Cheat Sheetもいろいろあるらしく、Cheat Sheet自体のまとめサイトが出てきてる。

- もっとよいGitチートシート - 西尾泰和のはてなダイアリー
-- http://d.hatena.ne.jp/nishiohirokazu/20110420/1303300536
- gitの仕組みがグラフィカルにすっきりわかるチートシート『Git Cheatsheet』 | IDEA*IDEA
-- http://www.ideaxidea.com/archives/2010/11/git_cheetsheet.html
- Git チートシート・ビジュアル解説・Tipsまとめ - NAVER まとめ
-- http://matome.naver.jp/odai/2133603706882852201

** その他

- 環境、OSごとに.gitconfigの設定を切り替えたい - みちしるべ
-- http://d.hatena.ne.jp/orangeclover/20120924/1348483488

* WindowsでのGit利用

色々バリエーションがあると思いますが、2013年前半で試した感じでは TortoiseGit 1.8系 + msysgit 1.8系で安定して利用できています。

インストールする順番としては、TortoiseSVN -> msysgitの順っぽいです。

- tortoisegit - Windows Shell Interface to Git - Google Project Hosting
-- https://code.google.com/p/tortoisegit/
-- SetupHowTo - tortoisegit - System prerequisites, Installation and upgrade howto - Windows Shell Interface to Git - Google Project Hosting
--- https://code.google.com/p/tortoisegit/wiki/SetupHowTo

msysgitですが、git-scm.comからWindows用をダウンロードすれば問題ありません。ドキュメントによっては "Full installer for official Git for Windows" とか書いてあったりして混乱しそうですが、少なくともgit-scm.comからのWindows用ダウンロードで一般的な利用には問題ないと思います。
- http://git-scm.com/downloads
-- サイトが飛び飛びになっていて分かりづらいんですが、↑からDLすれば、最終的にmsysgitをDLしたことになります。
- msysgit自体のサイト：
-- https://code.google.com/p/msysgit/
- ただ、開発の中心はgithubに移ったらしく、公式Webページとしては以下のサイトが最新のようです。
-- http://msysgit.github.io/
-- ちょっとややこしいですが、こちらのサイトの"Downloads"リンクをたどると、msysgitのcode.google.com側のファイルダウンロード画面に遷移します。(2013-07現在)
-- 多分、ソースコードリポジトリやWebサイトとしてはgithub.ioに移動したが、バイナリファイルの配布についてはcode.google.com側を使っている状況なんでしょうか。
-- https://code.google.com/p/msysgit/downloads/list を見てみると、Portableなパッケージや、"msysGit-fullinstall-xxxxx..." というパッケージもあったりします。TortoiseGitの説明にある"Full installer for official Git for Windows" というのは多分コレのことを指してるのかも。
-- git-scm.comからDL出来るのは、Portableも、fullinstallでもない、Git-1.x.x.... のようです。一応これをインストーするすればMSysも全部入りで使えますので、わざわざ"fullinstall"とか選ぶ必要はないかもしれません。
-- ただ、用途によってはPortableなものを入れたい人はそちらにして、TortoiseGit側で適宜設定変更しても大丈夫かも。

以下、 "Git-1.8.3-preview20130601.exe" のインストールの流れです。

1. セットアップ開始 -> "Next"
&image(yb://images/git_tips/msysgit_install1.png)

2. GPLへの同意 -> "Next"
&image(yb://images/git_tips/msysgit_install2.png)

3. コンポーネントの選択 : msysgitのため、msys側のbashとの連携オプションが選べます。・・・が、TortoiseGitにフロントエンドは一任するのであれば、各種連携機能をOFFにしても問題ありません。
&image(yb://images/git_tips/msysgit_install3.png)

4. ということで連携コンポーネントは全部OFFにして "Next"
&image(yb://images/git_tips/msysgit_install4.png)

5. GitへのPATH設定ですが、これもTortoiseGitをフロントエンドにして、そちらで直接git.exeへのフルパスを指定出来ますので、"Use Git Bash Only"を選択して、システム全体への環境変数は弄らないようにしておきます。
&image(yb://images/git_tips/msysgit_install5.png)

6. 改行コードです。変に自動変換されるとトラブルの元ですので、as-isにします。
&image(yb://images/git_tips/msysgit_install6.png)

7. インストール中。
&image(yb://images/git_tips/msysgit_install7.png)

8. あとは、TortoiseGit側のMSysGitの設定で↑でインストールしたgit.exeのbinフォルダを指定すればOKです。
&image(yb://images/git_tips/msysgit_install8.png)


#navi_footer|技術|