733d52235267b06c35e21c90ef9fae2aa32b484e
[arvados.git] / README
1 Sample Arvados web service.
2
3 usage: arv-web-example.py [-h] --project PROJECT [--port PORT] --image IMAGE
4
5 optional arguments:
6   -h, --help         show this help message and exit
7   --project PROJECT  Project to watch
8   --port PORT        Local bind port
9   --image IMAGE      Docker image to run
10
11
12 This queries an Arvados project and FUSE mounts the most recently modified
13 collection into a temporary directory.  It then runs the supplied Docker image
14 with the collection bind mounted to /mnt inside the container.
15
16 When a new collection is added to the project, or an existing project is
17 updated, it will detect the change, it will stop the running Docker container,
18 unmount the old collection, mount the new most recently modified collection,
19 and restart the Docker container with the new mount.
20
21 The supplied Dockerfile builds a Docker image that runs Apache with /mnt as the
22 DocumentRoot.  This allows you to browse the mounted collection with Apache's
23 default index page.
24
25
26 Suggestions for extension:
27
28 Configure the container to use mod_passenger (for an example,
29 arvados/docker/passenger/Dockerfile) and include both your web app and your
30 data in your collection.