Skip to content

Latest commit

 

History

History
52 lines (32 loc) · 1.85 KB

README_ja.md

File metadata and controls

52 lines (32 loc) · 1.85 KB
Raw

XrosFS

Build Status

XrosFS は稼働中の Docker コンテナのファイルシステムを FUSE 経由でマウントするツールです.

  • コンテナ側へ追加のエージェント等をインストールする必要あはりません. docker exec が許可されていていれば利用できます.
  • XrosFS と autofs、sshfs を組み合わせることで、他のコンテナを自動マウントするコンテナ(xros-over-sshfs)も用意してあります.

Requirements

Docker ホスト側

  • Python 3.5 以上
  • FUSE 2.6 (or later)
  • docker exec を実行できる権限

Docker コンテナ側

  • シェル(ash or bash)と基本的なツール(test,stat,dd, base64 etc.) (基本的には、alpine debian centos のプレーンイメージにインストールされています)

Installation

pip install xrosfs

Usage

container1 の / を ~/mnt へマウントする.

$ xrosfs container1:/ ~/mnt

なお、上記の例では container1 へ root として接続しています. 接続するユーザーを指定する場合は、user@container1:/ と記述します.

Known Issues

  • 改行を含むファイル名を扱えません.
  • 動作が超絶遅いです.
  • いくつかの操作メソッドは完全には実装されていません(flush(fsync) utimens 等).
  • umask オプションが指定されない場合は、ローカル側の umask 値が使用されます(ローカルの umask が 0002 で サーバーが 0022 だった場合、sshfs と xrosfs の mkdir fooの結果は異なります).

License

Copyright (c) 2018 hankei6km

Licensed under the MIT License. See LICENSE.txt in the project root.