Mercurial入門(後半)

ハンズオンその１
Mercurial入門
名古屋アジャイル勉強会分科会
開発ツール勉強会 #1 Mercurial入門
後半資料

2011年12月10日(土) You&I

3.Mercurialの使い方

1. (分散)バージョン管理システムとは
2. Mercurialとは
3. Mercurialの使い方(実習)
4. まとめ

 今回はシンプルに、以下の構成を構築
し、Mercurialがどのような動作にな
るのかを体験して頂きます。
◦ 中央リポジトリ方式
◦ ユーザー2人


環境の確認
Mercurialの
インストール状況
を確認する。

環境の確認(1/4)
 まずは、ターミナルコンソール・コマ
ンドプロンプトを起動しましょう。
 以下の指示に従って下さい。
1. 以下のコマンドを実行
hg version
hg versio
hg vers

 このようにMercurialのコマンドは、
コマンドの省略が可能となります。
 どこまで省略できるかは、似た名前の
コマンドが存在するか否かで決定され
ますので、コマンドを実行して覚えま
しょう。

 以下の指示に従って下さい。
hg help
hg help | more
 helpコマンドを実行すると、利用可能
なコマンドの一覧が確認出来ます。プ
ラグインを有効にすると、利用可能な
プラグインも表示されます。

 Mercurialのコマンドは、基本的にリ
ポジトリが存在するフォルダでのみ実
行が可能なコマンドが殆どです。
hg status


リポジトリの作成
Mercurialの
リポジトリ
を作成する。

リポジトリの作成(1/5)
 リポジトリの作成前に、まず今回の勉
強会用の作業フォルダを作成します。
mkdir C:¥TEMP¥758agile¥handson1 (Windows)
mkdir –p ~/758agile/handson1 (Linux/Mac)
cd "1の手順のパス"

 リポジトリを作成する
hg init repos
cd repos
dir (Windows)
ls -la (Linux/Mac)

 リポジトリのある場所でコマンドを実
行する
hg status
hg st
hg summary
hg sum

 リポジトリの作成はinitコマンドを実
行するだけで可能。
 各コマンドの詳細情報はhelpコマンド
で調べられます。
hg help init

 フォルダ構成の確認
◦ ～/758agile
 handson1
 repos
 .hg


リポジトリの複製
リポジトリを複製し
自分の作業スペースを
用意する。

リポジトリの複製(1/4)
 リポジトリを複製するに辺り、作業場
所を移動する。
cd C:¥TEMP¥758agile¥handson1 (Windows)
cd ~/758agile/handson1 (Linux/Mac)

 リポジトリを複製する。
hg clone .¥repos myself (Windows)
hg clone ./repos myself (Linux/Mac)
hg clone .¥repos other (Windows)
hg clone ./repos other (Linux/Mac)

 リポジトリを複製する。
3. 以下のファイルをエディタで開く
notepad .¥other¥.hg¥hgrc (Windows)
vi ./other/.hg/hgrc (Linux/Mac)
4. 以下の内容を追記する
[ui]
username = other

◦ 758agile
 handson1
 repos ・・・共有リポジトリ
 .hg
 myself ・・・自分用リポジトリ
 .hg
 other ・・・他人のリポジトリ
 .hg ・・・このリポジトリへの変更はother
ユーザー固定


ユーザー設定
Mercurialの
利用ユーザー毎の
設定を行う。

ユーザー設定(1/3)
 一般的なバージョン管理システムでは
コミットを行う際に、ユーザー情報の
入力が必要になります。
 最近のバージョン管理システムでは、
設定ファイルにて、ユーザー情報を指
定しておく事で、コミット時にその設
定情報が自動的にリポジトリへと登録
されます。

 Windowsの場合
◦ エクスプローラーを使い、Mercurialのイ
ンストール先(C:¥Program
Files¥Mercurial)から「Mercurial.ini」
を「%USERPROFILE%」にコピーする。
 Linux/Macの場合
touch ~/.hgrc

 [ui]セクションに以下の行を追加する。
メモ帳or vi/emacs等を利用します。
[ui]
username = 皆さんのお名前 <e-mail>
 Linux/Macの場合manコマンドでファイ
ルのフォーマットの仕様が確認出来ま
す。
man hgrc


ファイルの
追加・解除
リポジトリに
ファイルやフォルダの
追加・解除を行う。

ファイルの追加・解除(1/4)
 作業場所を移動する。
cd C:¥TEMP¥758agile¥handson1¥myself
(Windows)
cd ~/758agile/handson1/myself (Linux/Mac)
2. 「aaa.txt」というファイルを作成する
echo hogehoge > aaa.txt
hg status
hg st

 ファイルをリポジトリの管理下に置い
たり、解除したりする。
hg add aaa.txt
hg st
hg forget aaa.txt
hg st

 hgのコマンドは単色表示なので分かり
にくい。拡張機能を有効にして見やす
くする。
notepad %USERPROFILE%¥Mercurial.ini
(Windows)
vi ~/.hgrc (Linux/Mac)

 hgのコマンドは単色表示なので分かり
にくい。拡張機能を有効にして見やす
くする。
2. [extensions]セクションに以下の行を
追加又はセミコロン(;)を削除して有効
化する。
[extensions]
color =
[color]
mode = win32 (Windows)
mode = ansi (Linux/Mac)


ファイルの
コミット・削除
リポジトリに
ファイルを
設定・設定解除する。

ファイルのコミット・削除(1/5)
 ファイルをリポジトリにコミットする。
hg add aaa.txt ：リポジトリの管理下に
hg st ：変更ファイルの確認
hg commit ：変更分をコミット
2. 「aaa.txt」の内容を変更する
echo ageage >> aaa.txt
hg st ：変更ファイルの確認
hg ci ：変更分をコミット

 リポジトリのファイル削除
1. 「bbb.txt」というファイルを作成する
echo hogehoge > bbb.txt
hg add bbb.txt
hg ci
hg remove bbb.txt ：リポジトリのファイル
削除
hg ci

 リポジトリのファイルの移動
1. 「ccc.txt」というファイルを作成する
echo hogehoge > ccc.txt
hg add ccc.txt
hg ci
hg rename ccc.txt dir¥ddd.txt (Windows)
hg rename ccc.txt dir/ddd.txt
(Linux/Mac)
hg ci

 ファイル操作の確認
1. 「eee.txt」というファイルを作成する
echo hogehoge > eee.txt
hg add eee.txt
hg ci
del /F eee.txt (Windows)
rm –f eee.txt (Linux/Mac)

 ファイル操作で削除したファイルをリ
ポジトリの内容で復活させる
hg update -C -r tip
dir (Windows)
ls -l (Linux/Mac)


他のリポジトリ
との同期
他のリポジトリ
と同期して
変更内容を送受信する。

他のリポジトリと同期(1/15)
◦ 758agile
 handson1
 repos ・・・共有リポジトリ
 .hg
 myself ・・・自分用リポジトリ
 .hg
 other ・・・他人のリポジトリ
 .hg

 Diffツールの設定
(Windows)
[extdiff]
cmd.winmerge = "C:¥Program
Files¥WinMerge¥WinMergeU.exe" (Windows)
cmd.vimdiff = vimdiff (Linux/Mac)

 Diffツールの設定
3. 以下の内容を修正する (Windows)
[merge-tools]
winmerge.args=/e /x /wl /ub /dl other /dr
local $other $output $local
4. 以下の内容を追記する (Linux/Mac)
[merge-tools]
vimdiff.args=$local $other $base
vimdiff.priority=-10

 これまでの修正内容を確認する。
hg log
hg log -l 3
hg summary
hg sum

 myselfフォルダの変更内容を共有リポ
ジトリにpushする。
hg outgoing
hg out
hg push

 reposフォルダの共有リポジトリの状
態を確認する。
1. 新規にターミナルコンソールを起動する
cd C:¥TEMP¥758agile¥handson1¥repos
(Windows)
cd ~/758agile/handson1/repos (Linux/Mac)
hg log

 otherフォルダで共有リポジトリと同
期する。
1. 新規にターミナルコンソールを起動する
cd C:¥TEMP¥758agile¥handson1¥other
(Windows)
cd ~/758agile/handson1/other (Linux/Mac)
hg log

 otherフォルダで共有リポジトリと同
期する。
hg incoming
hg in
hg pull
hg update
hg pul

 otherフォルダで変更を行う。
1. 「123.txt」というファイルを作成する
echo hogehoge > 123.txt
hg add 123.txt
hg diff ：変更内容を確認する
hg diff | more

 otherフォルダで変更を行う。
hg ci
hg in
hg out
hg push

 otherフォルダの変更をmyselfフォル
ダに取り込む。
1. 「aaa.txt」を変更する
echo magemage >> aaa.txt
2. 「fff.txt」というファイルを作成する
echo hogehoge > fff.txt
hg add fff.txt ：まだコミットしない

 otherフォルダの変更をmyselfフォル
ダに取り込む。
hg in
hg pull
hg up
hg ci
hg push

 myselfフォルダの変更をotherフォル
ダに取り込む。(マージ)
1. 「aaa.txt」を変更する
echo mogmog > aaa.txt
hg st
hg in
hg pull

 myselfフォルダの変更をotherフォル
ダに取り込む。(マージ)
hg up (変更内容によってはエラー)
hg merge (変更内容によっては不要)
hg ci
hg push

 自分のローカルで未コミットのファイ
ルがある状態でmerge/updateコマンド
を実行するのは止めた方が良いです。
 分散バージョン管理の利点の1つとし
て、自分の変更分のコミットと、他人
の成果のマージのコミットが分離され
る事にあると思います。


変更を戻す
リポジトリへの
変更なかった事にする。

変更を戻す(1/4)
 revertコマンドでコミット前のファイ
ルを元に戻す。
1. 「fff.txt」を更新する
echo ageage >> fff.txt
2. 以下のコマンドを実行する
hg revert fff.txt
more < fff.txt

 rollbackコマンドで過去一回分のコ
ミットを戻す。
hg ci
hg sum
hg rollback
more < fff.txt

 rollbackコマンドで過去一回分のコ
ミットを戻す。
hg sum
hg rollback

 backoutコマンドで指定したコミット
を打ち消す変更を行う。
hg ci
hg sum
hg backout --merge -r [2のコミット番号]
hg ci


変更履歴を確認
リポジトリの
変更履歴を確認する。

変更履歴を確認する(1/5)
 myselfフォルダで変更する。
1. 「bbb.txt」を変更する
echo myself >> bbb.txt
hg ci
hg push

 myselfフォルダで変更を取り込む前に
otherで変更する。
1. 「eee.txt」を変更する
echo other >> eee.txt
hg ci
hg push
hg pul
hg push

 変更履歴をグラフィカルに行う
(Windows)
[extensions]
graphlog =
hg glog

 コマンドのデフォルト値の設定
(Windows)
[defaults]
glog = -l 3
hg glog

 ファイル内で行単位で過去のコミット
の状態を表示する
hg annotate aaa.txt


指定リビジョンに移動
リポジトリの中
を移動する。

指定リビジョンに移動(2/2)
 過去のコミットの状態に移動する
hg glog
hg up -clean -r [リビジョン番号]
hg glog
hg sum

指定リビジョンに移動(2/2)
 過去のコミットの状態に移動する
1. 「bbb.txt」を変更する
echo myself >> bbb.txt
hg ci
hg glog
hg merge -r [もう一つの分岐先]
hg glog


タグ付け
リポジトリの
ある位置に
タグを付与する。

タグ付け
 tagコマンドを利用する事である時点
のコミットに名前を付ける事が可能に
なります。
hg tag [タグラベル]
hg tags
 tagコマンドの使い所としては、バー
ジョンの区切りを示すのに使ったりし
ます。


エクスポート
リポジトリの内容
をファイル出力する。

エクスポート(1/1)
 myselfの内容をZIP書庫に出力する
1. 以下のコマンドを実行(例：リポジトリ
全部)
hg archive -r tip -t
zip ../export.zip
2. 以下のコマンドを実行(例：dddフォルダ
のみ)
hg archive -r tip -t zip
../export.zip -I ./ddd

4.まとめ(1/2)
 一連の動作を実際に確かめてみて如何
でしたでしょうか？
 今回は本当に初歩の部分しかやらな
かったので、現場で導入する場合には、
共有リポジトリは別PCとなるのでどの
ように設定すべきなのか、という問題
があります。
 まずは自分の環境のみでコツコツ使っ
てみましょう。

4.まとめ(2/2)
 今回色々とextensionも利用しながら
ハンズオンを行いました。
 次なるステップとしては、rebaseや
bookmarkといったextensionを使いこ
なす事で、共有リポジトリを見やすい
状態に保つ事にチャレンジしてみま
しょう。

Mercurial入門(後半)

More Related Content

What's hot

Viewers also liked

Similar to Mercurial入門(後半)

Mercurial入門(後半)