Skip to content
Snippets Groups Projects

CloWM Workflow Service

Description

This is the Workflow service of the CloWM service.

Environment Variables

Mandatory / Recommended Variables

Variable Default Value Description
PUBLIC_KEY_VALUE / PUBLIC_KEY_FILE randomly generated Public Key / Path to Public Key Public part of RSA Key in PEM format to verify JWTs
DB_HOST unset <db hostname / IP> IP or Hostname Address of DB
DB_PORT 3306 Number Port of the database
DB_USER unset <db username> Username of the database user
DB_PASSWORD unset <db password> Password of the database user
DB_DATABASE unset <db name> Name of the database
OBJECT_GATEWAY_URI unset HTTP URL HTTP URL of the Ceph Object Gateway
BUCKET_CEPH_ACCESS_KEY unset <access key> Ceph access key with admin privileges
BUCKET_CEPH_SECRET_KEY unset <secret key> Ceph secret key with admin privileges
OPA_URI unset HTTP URL HTTP URL of the OPA service
SLURM_ENDPOINT unset HTTP URL HTTP URL to communicate with the Slurm cluster
SLURM_TOKEN unset <JWT> JWT for communication with the Slurm REST API. Should belong to the user SLURM_USER

Optional Variables

Variable Default Value Description
API_PREFIX /api/workflow-service URL path Prefix before every URL path
BACKEND_CORS_ORIGINS [] json formatted list of urls List of valid CORS origins
SQLALCHEMY_VERBOSE_LOGGER False <"True"&#x7c;"False"> Enables verbose SQL output.
Should be false in production
PARAMS_BUCKET nxf-params Bucket Name Bucket where the nextflow configurations for each execution should be saved
WORKFLOW_BUCKET clowm-workflows Bucket Name Bucket where to save important workflow files
ICON_BUCKET clowm-icons Bucket name Bucket where to save workflow icons. Should be publicly available.
SLURM_USER slurm string User on the slurm cluster who should run the job. Should be the user of the SLURM_TOKEN
PARAMS_BUCKET_MOUNT_PATH /mnt/params-bucket Path on slurm cluster Folder where the S3 bucket PARAMS_BUCKET will be mounted on the slurm cluster
NX_CONFIG unset Path on slurm cluster Configuration file on the slurm cluster that is the same for every nextflow run
NX_BIN nextflow Path on slurm cluster Path to the nextflow executable. Default it is in the PATH
SLURM_WORKING_DIRECTORY /tmp Path on slurm cluster Working directory for the slurm job with the nextflow command
ACTIVE_WORKFLOW_EXECUTION_LIMIT 3 Integer Limit of active workflow execution a user is allowed to have. -1 means infinite.
DEV_SYSTEM False <"True"&#x7c;"False"> Activates an endpoint that allows execution of an workflow from an arbitrary Git Repository.
HAS TO BE False in PRODUCTION!
OPA_POLICY_PATH /clowm/authz/allow URL path Path to the OPA Policy for Authorization

Nextflow Variables

All Nextflow environment variables with the prefix NXF_ are also support when submitting a job to the slurm cluster, e.g. pinning the Nextflow version

NXF_VER=23.04.0