はじめてのgithub

いろんなBlog巡回してると、どこもかしこもgit, gitなのでアカウントだけ作って放置してたgithubで昔に書いたちょこちょこしたコードをコミットしてみました。

• github/katsuma
• katsuma / mt-delicious-bookmark-counter
• katsuma / flickr-gadget
• katsuma / sbm-comment

さすがにはじめてのgitは戸惑うことばかりだったので、メモを残しておきたいと思います。

gitのインストール

作業OSはMac OSXです。ソースからもインストールできますが、管理しやすいようにMac portsでインストールしてしまいます。

sudo port -d sync # 同期
port search git # cogito, git-core, stgit, cgitあたりがあるはず. git-coreを選択
port variants git-core # オプションを確認, 今回はgitweb, svnを指定
sudo port install git-core +gitweb +svn

これで

$ git version 
git version 1.6.1.2

なんかの表示になるとインストールOKですね。

gitのglobal設定

まず、名前とメールアドレスの設定をしておきます。

$ git config --global user.name "ryo katsuma"
$ git config --global user.email katsuma＠gmail.com

githubでアカウントを作成

ここからサインアップ。とりあえずFreeのプランでいいと思います。

gravatarでアカウントを作成

gitを使うだけだとここは飛ばしてもいいのですが、githubのアカウントのアバター画像を何か設定したい場合はgravatarのアカウントが必要になります。たしかいろんなサイトでアバター画像を設定するの面倒だから共通化しようよ、みたいなサービスだったかと思います。（実際はgravatar使えるサービスってあまり目にしないのですが。。。）gravatarのアカウント作成はここから。

アカウントを作成したら「My Account」> 「Add an Image」から画像を追加。追加後に「G」「PG」「R」「X」の４つの中からRatingが選択できるようになっているので、ここで「G」を選択しておきます。「Global」というわけで、どのWebサービスでも利用できる、という意味ですね。

ここで、Ratingを選ぶ画面が出てこない場合は、画像の追加からやり直しておきましょう。実際、僕はGravatarのアカウントだけ作って放置してたら処理がおかしくなてどうやってもRatingを選択できませんでした。 そこで画像の追加からやり直したら、うまくいきましたので。

さて、githubのアカウント設定ページに戻ってみましょう。サムネイルの画像がちゃんと表示されてあればGtavatarの設定はOKです。

SSH公開鍵をgithubに登録

githubにpushするときに、SSH公開鍵を登録しておく必要があるようです。公開鍵は自分のホームディレクトリで

$ ssh-keygen

で、$HOME/.ssh/の箇所にid_rsa.pubの名前で作成されます。この内容をコピーしておいて、githubのaccountのページの「SSH Public Keys」の箇所で登録しておきます。（Titleは適当でOK）

レポジトリを作成

まず、github上で管理したいプロジェクトのレポジトリを作成します。githubにログインした状態でトップページの「Create a Repository」から作成します。とりあえず今回は「Rubyでブックマークカウンタの修正スクリプト書きました」のMTBookmarkCounterのdelicious用修正スクリプトをpushするレポジトリを作りたいと思います。レポジトリ名は「MT Delicious Bookmark Counter」で作成することにします。

githubにpush

作成後はレポジトリにpushする方法が表示されるので、基本的にはこれに習うことにします。

まず、ローカルでpushしたいファイルがある場所に移動します。その後、

git init

で、作業ディレクトリの初期化を行います。

git add delicious.rb simple-json.rb

で、コミットしたいファイルを登録します。

git commit -m 'first commit'

で、実際にローカルにコミットします。ここではコミット時のコメントが「first commit」になっているわけですね。

git remote add origin git@github.com:katsuma/mt-delicious-bookmark-counter.git

で、リモートレポジトリに登録します。ここでは「github:{githubのユーザ名}/{githubで管理したいレポジトリ名}」になっています。ここでのレポジトリ名は、さっきgithub上でレポジトリを作成したときに表示されているはずなので、それに従います。

git push origin master  

で、実際にgithubにpushされます。ここで、SSH公開鍵の設定などに不備があるとエラーになります。特にエラーメッセージが表示されない場合は、pushできているはずなので、確認してみましょう。たとえば今回のレポジトリだと、このようにアクセスできるはずです。

まとめ

実際は作業をしている中で公開鍵まわりでエラーがよく出て、なかなかpushするのに手間取っていました。ただ、コミットはものすごく簡単にできるので、手元で気軽にバージョン管理するにはかなりよさそうです。

とりあえず僕の方針として、大きめのプロジェクトなんかはGoogle codeなんかでホスティングして、小ネタなんかはどんどんgithubにpushしていくことにしたいと思います。あと、.zshrcとか設定ファイルなんかをpushしておくのもいいかもですね。