Mercurial入門(後半)解説版

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

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

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


リポジトリ
(repos)

リポジトリリポジトリ
(myself) (other)
作業コピー作業コピー

分散リビジョン管理方式(中央サーバー利用)


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

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

 このようにMercurialのコマンドは、
コマンドの省略が可能となります。
 どこまで省略できるかは、似た名前の
コマンドが存在するか否かで決定され
ますので、コマンドを実行して覚えま
しょう。
1. 以下のコマンドを実行(Windowsのみ)
set LANG=ja
hg vers

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

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

環境の確認(解説)
 Mercurialのコマンドについて以下の
事を確認する
◦ Mercurialのコマンドは、省略形がある。
◦ Mercurialのhelpコマンドの使い方。
◦ 殆どのMercurialのコマンドは、リポジト
リが存在するフォルダ配下でのみ実行可
能である。


リポジトリの作成
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
hg help [コマンド名]

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

リポジトリの作成(解説)
 以下の事を実施・確認
◦ ハンズオン用の作業フォルダ作成。
◦ ハンズオン用の共有リポジトリ作成。
◦ リポジトリにはどのようなファイル・
フォルダがあるか確認する。
◦ リポジトリ配下で実行可能なMercurialの
コマンドを確認
◦ コマンド毎のhelpコマンドの使い方を確
認する。


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

リポジトリの複製(1/3)
 リポジトリを複製するに辺り、作業場
所を移動する。
cd C:¥TEMP¥758agile¥handson1 (Windows)
cd ~/758agile/handson1 (Linux/Mac)
 リポジトリを複製する。
hg clone repos myself (自分用)
hg clone repos other (他人用)

 リポジトリを複製する。
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のイ
ンストール先から「Mercurial.ini」を
「%USERPROFILE%」にコピーする。
インストール先：C:¥Program Files¥Mercurial
 Linux/Macの場合
touch ~/.hgrc

 [ui]セクションに以下の行を追加する。
メモ帳/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)

ファイルの追加・解除(解説)
◦ ファイルをリポジトリの管理下に置く、
管理下から解除する。
◦ ファイルの追加時に、statusコマンドが
どのような表示になるか確認する。
◦ 設定ファイルにMercurialのコマンドの実
行結果をカラー表示にする設定を追加す
る。


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

ファイルのコミット・削除(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)

ファイルのコミット・削除(解説)
◦ リポジトリにファイルを追加・削除する。
◦ リポジトリに追加したファイルを移動す
る。
◦ リポジトリに追加したファイルを、ファ
イルシステム操作により削除し、update
コマンドでファイルを復活させる。


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

他のリポジトリと同期(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/2)
◦ merge操作用のマージツールの設定を行う。
◦ logコマンドでリポジトリのコミット履歴
を確認する。
◦ summaryコマンドでリポジトリの最新状態
を確認する。
◦ outgoingコマンドでリポジトリ同期先へ
の送信情報を確認する。
◦ pushコマンドでリポジトリを同期する。

他のリポジトリと同期(解説)
 以下の事を実施・確認(2/2)
◦ incomingコマンドでリポジトリ同期先か
らの受信情報を確認する。
◦ ローカルに未コミットの変更がある状態
で、pullコマンドでリポジトリ内容を同
期する。
※通常はpullする前には未コミットの変更はコ
ミットするなりして、退避して下さい。
◦ 1つのファイルを2ユーザーが変更し、
mergeコマンドが必要になるのを確認する。


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

変更を戻す(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

変更を戻す(確認)
 以下の事を実施・確認する。
◦ revertコマンドでコミット前のファイル
を元に戻す。
◦ rollbackコマンドで1回分のコミットを
元に戻す。一度rollbackすると連続して
rollbackコマンドが実行できない事を確
認する。
◦ backoutコマンドで指定したコミットを
打ち消す変更のコミット操作を行う。


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

変更履歴を確認する(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

変更履歴を確認する(確認)
◦ graphlog拡張コマンドを有効にする。
◦ glogコマンドの実行結果を確認する。
◦ annotateコマンドでファイルの行単位
でコミットの履歴を確認する。


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

指定リビジョンに移動(1/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

指定リビジョンに移動(確認)
◦ updateコマンドで簡単に過去のリビジョ
ンに戻る事ができるのを確認する。
◦ 過去のリビジョンに対して変更・コミッ
トを行うと、無名ブランチが作成され、
リポジトリが分岐する事を確認する。
◦ mergeコマンドで分岐したリポジトリをま
た1つにする。


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

タグ付け
 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


不要なファイルの除外
リポジトリの管理外
にするファイルを
指定する。

不要なファイルの除外(1/2)
 mergeやupdateコマンドの実行によっ
て、*.bakや*.origといったファイル
が増えます。statusコマンドの実行の
の度にこれらのファイルの表示は邪魔
なので表示しないようにしましょう。
cd C:¥TEMP¥758agile¥handson1¥myself
(Windows)
cd ~/758agile/handson1/myself (Linux/Mac)

不要なファイルの除外(2/2)
echo syntax: glob > .hgignore
2. .hgingoreファイルを開く
notepad .hgignore (Windows)
vi .hgignore (Linux/Mac)
*.bak
*.orig
4. 正規表現でのフィルタも可能
http://www.selenic.com/mercurial/hgignore.5.html

不要なファイルの除外(確認)
◦ .hgignoreファイルをリポジトリのトップ
ディレクトリに置く事で、サブフォルダ
を含めて、ファイルのフィルタが可能に
なる事を確認する。

Mercurial入門(後半)解説版

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (19)

Similar to Mercurial入門(後半)解説版

Similar to Mercurial入門(後半)解説版 (20)

Recently uploaded

Recently uploaded (14)

Mercurial入門(後半)解説版