Unisonのソースを表示

[[Category:同期]]
[[de:Unison]]
[[en:Unison]]
[[zh-hans:Unison]]
'''Unison''' は Unix ライクなオペレーティングシステム (Linux, macOS, Solaris) や Windows で動作する双方向性のファイル同期ツールです。ファイルやディレクトリの複製を別々のホスト (あるいは同一ホスト上の別々のディスク) に保存して、それぞれ別個に変更を加えて、後から複製の変更を相互に持ち寄って最新状態にすることができます。どんなシステムでもホストにすることが可能です。

== インストール ==

{{Pkg|unison}} パッケージを[[インストール]]してください。CLI, GTK+, GTK+ 2.0 のインターフェイスが入っています。

== 設定 ==

Unison を使用するには、プロファイルを作成する必要があります。

=== GUI ===

GUI で Unison を設定するには次を実行:
 $ unison-gtk2

=== 手動 ===

もしくは、{{ic|~/.unison}} にプロファイルを手動で作成して、以下の行をデフォルトの設定ファイルである {{ic|~/.unison/''profilename''.prf}} に追加してください。

同期するルートディレクトリを定義:
 root=/home/user/

ファイルを同期する先のリモートディレクトリを定義:
 root=<nowiki>ssh://example.com//path/to/server/storage</nowiki>

任意で、[[SSH]] にわたす引数を指定:
 sshargs=-p 4000

同期するディレクトリとファイルを定義:
 # dirs
 path=Documents
 path=Photos
 path=Study
 # files
 path=.bashrc
 path=.vimrc

無視するファイルも定義できます:
 ignore=Name temp.*
 ignore=Name .*~
 ignore=Name *.tmp

{{note|プロファイルの詳細は [http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html User Manual and Reference Guide] にある [http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html#profileegs サンプルプロファイル] を参照してください。}}

== 使用方法 ==

プロファイルを設定したら、次のコマンドで同期を開始できます:
 $ unison ''profilename''
もしくは GUI ツールを使用してプロファイルを選択してください:
 $ unison-gtk2
Unison のインターフェイスでは進捗や変化を見ることができます。

== バージョンの不適合 ==

Unison が正しく機能しない場合、クライアントにインストールされている Unison のバージョンおよびコンパイルに使用した [https://ocaml.org/ OCaml] のバージョンが一致しているか確認してください。

Arch と他のディストリビューション間で同期を行う場合、大抵は OCaml と Unison をどちらかで手動でコンパイルする必要があります。

[[AUR]] にはバージョン 2.32 ({{AUR|unison-232-compat}}) と 2.40 ({{AUR|unison-240-compat}}) の非公式 PKGBUILD が存在します。

== ヒントとテクニック ==

=== 人間の時間と手間を省く ===

十分なスクロールバッファが確保できるターミナルエミュレータで unison を動作させる場合、変更箇所が衝突するたびに確認を要求するのは何の意味もありません。{{ic|auto}} オプションを true に設定することで確認を表示しないようにできます。

=== diff の出力を読みやすくする ===

unison のデフォルトの diff コマンドは {{ic|diff -u CURRENT2 CURRENT1}} です。このコマンドの出力を確認するとき、左から右に変更があったり ('>')、逆に右から左に変更があると ('<')、どこが変更されるのか分かりにくいのが難点です。以下の設定を使うことでそれが分かりやすくなります: '>' が適用される行には全て '>' が付くようになります:

 diff = diff -u CURRENT2 CURRENT1 | perl -pe 's/^\+/>/; s/^\-/</'

=== Emacs でマージ ===

Unison には外部のマージプログラムを使って衝突する2つのファイルのマージを手助けする機能が存在しますが、デフォルトではプログラムが設定されていません。マニュアルには以下のように設定することが提案されています:

 merge = Name *.txt -> emacs -q --eval '(ediff-merge-files-with-ancestor "CURRENT1" "CURRENT2" "CURRENTARCH" nil "NEW")'

マージコマンドはターミナルから実行することができないため、上記を使うには X で Unison を実行する必要があります (Emacs: "standard input is not a tty")。また、Unison は CURRENT1 などの変数をシングルクォートで囲まれたファイル名に置き換えます。そのため、"(ediff-merge-files... \"CURRENT1\" ...)" のようにダブルクォートを使用すると上手くいきません。

CURRENTARCH 変数は共通祖先による 3-way マージを使用することを Unison に指定します。最後の同期で "backupcurrent" が設定されていた場合にのみ 3-way マージになります。通常の 2-way マージをターミナルで実行したい場合、以下の設定を使ってください。ediff.el ではなく emerge.el を使っています:

 merge = Name {*,.*} -> urxvt -e emacs -nw -q --eval '(emerge-files nil "CURRENT1" "CURRENT2" "NEW")'

CURRENTARCH の代わりに CURRENTARCHOPT 変数が使われた場合、Unison は可能なときに共通祖先を使って、そうでない場合は (変数に空の文字列を設定して) 2-way マージにフォールバックします。シェルスクリプトで検知することが可能です。例:

 merge = Name {*,.*} -> unison-merge-files CURRENT1 CURRENT2 NEW CURRENTARCHOPT

{{ic|unison-merge-files}} を上記のように定義した場合:

 #!/bin/sh
 CURRENT1=$1
 CURRENT2=$2
 NEW=$3
 CURRENTARCHOPT=$4
 EMACS="urxvt -e emacs -nw"
 if [ x$CURRENTARCHOPT = x ]; then
     $EMACS --eval "(emerge-files nil \"$CURRENT1\" \"$CURRENT2\" \"$NEW\")";
 else
     $EMACS --eval "(emerge-files-with-ancestor nil \"$CURRENT1\" \"$CURRENT2\" \"$CURRENTARCHOPT\" \"$NEW\")";
 fi

=== 一般的な設定の同期 ===

システム (サーバー, ワークステーション, ノートパソコン, スマートフォンなど) 上の設定ファイルを同期する場合、基本的な部分 (キーバインドやシェルのエイリアスなど) だけを別の設定ファイル (例: {{ic|.bashrc_common}}) に分割して、変更がある部分 (アプリケーション特有の設定やセキュリティに関する設定など) だけを同期すると良いでしょう。

{{Warning|Bidirectional syncing of config files can lend itself to become an avenue for an attack, by enabling the peer syncing system to receive malicious changes to config files (and perhaps even other peers the system syncs with). This is an attractive option for adversaries, especially when the conceptual security levels of the two systems differ (e.g., public shell server vs. personal workstation), since it would likely be simpler to compromise a system of lower security. Always use the {{ic|noupdate}} option when bidirectional syncing between two particular systems is deemed unnecessary; when necessary, verify each change when syncing. Automatic bidirectional syncs should be done with extreme caution.}}

== 参照  ==

* [https://www.cis.upenn.edu/~bcpierce/unison/ 公式ウェブサイト]
* [https://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html ユーザーマニュアルとリファレンスガイド]
* [http://tech.groups.yahoo.com/group/unison-users Yahoo! ユーザーグループ]
* ''[http://www.pgbovine.net/unison_guide.htm Liberation through data replication]'' by Philip Guo
* ''[http://www.pgbovine.net/unison-for-your-mom.htm Setting up Unison for your mom]'' by Philip Guo
* ''[http://twiki.org/cgi-bin/view/Codev/ReplicationUsingUnison Replication using Unison]'' on TWiki