Gitfsのソースを表示

{{Lowercase title}}
[[Category:FUSE]]
[[Category:バージョン管理システム]]
[[en:Gitfs]]
[https://www.presslabs.org/gitfs/docs/ gitfs] より:
:gitfs は git と完全に統合された FUSE ファイルシステムです。リモートリポジトリのブランチをローカルでマウントすることができ、ファイルに変更を加えると自動的にリモートにコミットされます。
:あらゆるリポジトリをマウントすることができ、変更は全て自動的にコミットに変換されます。また、gitfs は全てのコミットのスナップショットをシミュレートすることで現在使用しているブランチの履歴を陳列します。
:gitfs は全てのファイルを追跡したい場合に有益ですが、同時に、コミットに変換されるのを自分で管理することはできません。

== インストール ==

{{Aur|gitfs}} を[[インストール]]してください。

== 使用方法 == 

gitfs を使うことでリモートの git リポジトリを [[Fuse|FUSE]] ファイルシステムとしてマウントできます。例:
 $ gitfs <nowiki>http://example.com/repository.git</nowiki> ''/mount/directory''

詳しくは [https://www.presslabs.org/gitfs/docs/arguments/ ドキュメント] を見てください。

== トラブルシューティング ==

=== /var/lib/gitfs への書き込み権限 ===

{{ic|/var/lib/gitfs}} ディレクトリが必要ですが自動では作成されません。通常ユーザーで gitfs をマウントしたい場合、そのユーザーに書き込み権限を与えてください:
 sudo mkdir /var/lib/gitfs
 sudo chown username:users /var/lib/gitfs

=== pygit2 への書き込み権限 ===

gitfs を最初に実行したとき、gitfs は自己解析を開始しますが、通常ユーザーで実行していると失敗します。一度 root で実行してください。何かマウントをする必要はありません。root でヘルプメッセージを表示するだけで十分です:

 sudo gitfs -h

=== ssh 鍵の使用 ===

Gitfs (と依存ライブラリの pygit2) は活発に開発されておりオプションも頻繁に変更されます。[https://www.presslabs.org/gitfs/docs/arguments/ 公式ドキュメント] では {{ic|1=-o key=}} オプションを使って鍵を変更できると書かれていますが、AUR のバージョン 0.4.1-1 では {{ic|1=-o ssh_key=}} を使う必要があります。鍵がパスフレーズによって保護されている場合、gitfs はパスフレーズを要求せず、ただエラーを返します:
 _pygit2.GitError: Failed to authenticate SSH session: Callback returned error
以下を実行して別の鍵を作成することを推奨します:
 ssh-keygen
 /home/user/.ssh/gitfs_rsa
 <empty passphrase>
 <empty passphrase again>