https://github.com/hankei6km/xrosfs

Mount a Running Docker Container File Sytem via FUSE.
https://github.com/hankei6km/xrosfs

docker docker-container docker-exec fuse mount sytem

Last synced: about 1 month ago
JSON representation

Mount a Running Docker Container File Sytem via FUSE.

• Host: GitHub
• URL: https://github.com/hankei6km/xrosfs
• Owner: hankei6km
• License: mit
• Created: 2018-01-31T08:11:20.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-02-15T10:12:51.000Z (almost 7 years ago)
• Last Synced: 2024-04-20T08:46:53.531Z (8 months ago)
• Topics: docker, docker-container, docker-exec, fuse, mount, sytem
• Language: Python
• Size: 89.8 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# XrosFS

[![Build Status](https://travis-ci.org/hankei6km/xrosfs.svg?branch=master)](https://travis-ci.org/hankei6km/xrosfs)

Mount a Running Docker Container File Sytem via FUSE.

* No requirement to install additional agents to container side. it's only required to have permitted to `docker exec` command.

* Docker container [xros-over-sshfs](https://hub.docker.com/r/hankei6km/xros-over-sshfs/) that mount other containers file system automatically  by XrosFS with autofs and sshfs is released.

## Requirements

### Docker Host Side

* Python 3.5 or later

* FUSE 2.6 (or later)

* Permitted to execute `$ docker exec`

### Docker Container Side

* Shell (`ash` or `bash`) and some commands(`test`, `stat`, `dd` `base64` etc.)

(Usually, they are already installed plain image of alpine, debian etc.)

## Installation

```bash

pip install xrosfs

```

## Usage

Mount `/` of `container1` to `~/mnt`.

```bash

$ xrosfs container1:/ ~/mnt

```

In above step, xrosfs connect to `container1` as `root` user.

Pass `user@container1:/` to xrosfs, if you want to connect as other users.

## Known Issues

* Can't access to file that had `\n` included filename.

* Bad response time in operates.

* Some operations methods are not full implemented yet(`flush(fsync)` `utimens` etc.).

* Using default umask value from local system value, when not pass `umask` option(`mkdir foo` resutls of sshfs and xrosfs are different, when local umask=0002 server umask=0022).

## License

Copyright (c) 2018 hankei6km

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