X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/88c382d13b3d6e6f3b03ba0d5139ad9552c3c359..c9bfa91e3c3ec90778795969fdd3787578a76ed4:/doc/install/arvbox.html.textile.liquid diff --git a/doc/install/arvbox.html.textile.liquid b/doc/install/arvbox.html.textile.liquid index 2420ff79b9..8827cf8abf 100644 --- a/doc/install/arvbox.html.textile.liquid +++ b/doc/install/arvbox.html.textile.liquid @@ -3,6 +3,11 @@ layout: default navsection: installguide title: Arvados-in-a-box ... +{% comment %} +Copyright (C) The Arvados Authors. All rights reserved. + +SPDX-License-Identifier: CC-BY-SA-3.0 +{% endcomment %} Arvbox is a Docker-based self-contained development, demonstration and testing environment for Arvados. It is not intended for production use. @@ -23,23 +28,27 @@ h2. Requirements h2. Usage
-Arvados-in-a-box - -arvbox (build|start|run|open|shell|ip|stop|reboot|reset|destroy|log|svrestart) +$ arvbox +Arvados-in-a-box http://arvados.org -build@@ -117,14 +126,14 @@ h2. Making Arvbox accessible from other hosts In "dev" and "localdemo" mode, Arvbox can only be accessed on the same host it is running. To publish Arvbox service ports to the host's service ports and advertise the host's IP address for services, use @publicdev@ or @publicdemo@:build arvbox Docker image +build build arvbox Docker image +rebuild build arvbox Docker image, no layer cache start|run start arvbox container open open arvbox workbench in a web browser shell enter arvbox shell -ip print arvbox ip address +ip print arvbox docker container ip address +host print arvbox published host status print some information about current arvbox stop stop arvbox container restart stop, then run again reboot stop, build arvbox Docker image, run reset delete arvbox arvados data (be careful!) destroy delete all arvbox code and data (be careful!) -log tail log of specified service -sv change state of service inside arvbox +log tail log of specified service +ls list directories inside arvbox +cat get contents of files inside arvbox +pipe run a bash script piped in from stdin +sv change state of service inside arvbox clone clone an arvbox
-$ arvbox reboot publicdemo +$ arvbox start publicdemoThis attempts to auto-detect the correct IP address to use by taking the IP address of the default route device. If the auto-detection is wrong, you want to publish a hostname instead of a raw address, or you need to access it through a different device (such as a router or firewall), set @ARVBOX_PUBLISH_IP@ to the desire hostname or IP address.
$ export ARVBOX_PUBLISH_IP=example.com -$ arvbox reboot publicdemo +$ arvbox start publicdemoNote: this expects to bind the host's port 80 (http) for workbench, so you cannot have a conflicting web server already running on the host. It does not attempt to take bind the host's port 22 (ssh), as a result the arvbox ssh port is not published.