add support for workers argument for container (#38)

* add support for workers argument for container
Signed-off-by: vsoch <[email protected]>

Author: vsoch

CHANGELOG.md

@@ -16,4 +16,5 @@ The versions coincide with releases on pip. Only major versions will be released
 ## [0.0.x](https://github.com/flux-framework/flux-restful-api/tree/main) (0.0.x)
  - Fixing bug with launcher always being specified (0.0.1)
   - catching any errors on creation of fluxjob
+  - Add support uvicorn workers (>1 needed to run >1 process with Flux)
  - Project (faux) skeleton release (0.0.0)

Dockerfile

@@ -2,13 +2,13 @@ FROM fluxrm/flux-sched:focal
 
 # docker build -t ghcr.io/flux-framework/flux-restful-api .
 
-
 # This must be set to work (username / token set won't trigger it alone)
 ARG use_auth
 ARG user="fluxuser"
 ARG token="12345"
 ARG port="5000"
 ARG host="0.0.0.0"
+ARG workers="1"
 LABEL maintainer="Vanessasaurus <@vsoch>"
 
 USER root
@@ -28,4 +28,5 @@ ENV FLUX_TOKEN=${token}
 ENV FLUX_REQUIRE_AUTH=${use_auth}
 ENV PORT=${port}
 ENV HOST=${host}
+ENV WORKERS=${workers}
 ENTRYPOINT ["/code/entrypoint.sh"]

docs/getting_started/developer-guide.md

@@ -35,6 +35,7 @@ Build arguments supported are:
 | use_auth | Turn on authentication | unset (meaning false) |
 | port | Port to run service on (and expose) | 5000 |
 | host | Host to run service on (you probably shouldn't change this) |0.0.0.0 |
+| workers | Number of workers to run uvicorn with (required for Flux jobs with >1 process) | 1 |
 
 And run it ensuring you expose port 5000. The container should show you if you've
 correctly provided auth (or not):
@@ -65,7 +66,7 @@ needing to push a container to a registry. Here is how to specify a branch (and
 or your own repository base:
 
 ```bash
-$ docker run  --env INSTALL_BRANCH=add/feature --env INSTALL_REPO=user/flux-restful-api -d --rm -it -p 5000:5000 ghcr.io/flux-framework/flux-restful-api
+$ docker run --env INSTALL_BRANCH=add/feature --env INSTALL_REPO=user/flux-restful-api -d --rm -it -p 5000:5000 ghcr.io/flux-framework/flux-restful-api
 ```
 
 

entrypoint.sh

@@ -13,4 +13,4 @@ fi
 
 # We always need to start in this PWD
 cd /code
-flux start uvicorn app.main:app --host=${HOST} --port=${PORT}
+flux start uvicorn app.main:app --host=${HOST} --port=${PORT} --workers=${WORKERS}