Add setup command for testing external apps

[manics]

When testing external clients it is useful to have an OMERO server without having to integrate the full test process into omero-test-infra.

See for example ome/omero-prometheus-tools#4

[joshmoore]

Nice. Do you know if you could have accomplished what you wanted using test-data, e.g.

• https://github.com/ome/rOMERO-gateway/blob/master/.omeroci/test-data
• https://github.com/openmicroscopy/omero-test-infra/blob/master/docker#L197

i.e. could prometheus tools follow the "lib" pattern?

Perhaps relatedly, I had a similar need recently and scratched it with:

commit 785a74261592853671e86e7874052f06ad0cbaef
Author: jmoore <josh@glencoesoftware.com>
Date:   Wed Aug 15 10:41:00 2018 +0100

    Add srvup and srvdown

diff --git a/docker b/docker
index c7a5f8b..23a43f6 100755
--- a/docker
+++ b/docker
@@ -42,7 +42,7 @@ fi
 $VERBOSE

 start_up() {
-    $ACTION .omero/compose up -d --force-recreate "$@"
+    $ACTION .omero/compose up -d --build --force-recreate "$@"
     if [ "$NOCLEAN" != "true" ]; then
         clean_up() {
             $ACTION .omero/compose down -v
@@ -213,6 +213,28 @@ for STAGE in $STAGES; do
             run py update
             run --user scripts build
             ;;
+        srvup)
+            export COMPONENT=server
+            export USER=omero-server
+            export CID="$PROJECT"_omero_1
+            export COMPOSE_FILE=${COMPOSE_FILE:-"srv-compose.yml"}
+            export OMERO_DIST="/opt/omero/server/OMERO.server"
+            export TARGET=/src
+            export NOCLEAN=true
+            start_up
+            install --nosrc
+            run py common
+            ;;
+        srvdown)
+            export COMPONENT=server
+            export USER=omero-server
+            export CID="$PROJECT"_omero_1
+            export COMPOSE_FILE=${COMPOSE_FILE:-"srv-compose.yml"}
+            export OMERO_DIST="/opt/omero/server/OMERO.server"
+            export TARGET=/src
+            export NOCLEAN=true
+            $ACTION .omero/compose down -v
+            ;;
         srv)
             export COMPONENT=server
             export USER=omero-server

but that's more generally the testing of ../Dockerfile (which is slow).

[joshmoore]

I'd include the NOCLEAN=true in the the stage itself.

[joshmoore]

This doesn't really match the rest of the naming structure. Moving this discussion to the review comment, but if srv is the testing of ../Dockerfile I'd be interested in a prefix other than omero-* that could represent this stage.

[manics]

No longer needed: ome/omero-prometheus-tools#4 (comment) (though more docs for this repo would be helpful)

[joshmoore]

👍 for collecting each of the external uses into a "Usage:" section of the README.