Skip to main content

BioMAJ process service

Project description

# About

[![PyPI version](](

Microservice to manage the process execution of biomaj.

A protobuf interface is available in biomaj_process/message/ to exchange messages between BioMAJ and the download service. Messages go through RabbitMQ (to be installed).

# Protobuf

To compile protobuf, in biomaj_process/message:

protoc –python_out=. message.proto

# Development

flake8 biomaj_process

# Run

## Message consumer: export BIOMAJ_CONFIG=path_to_config.yml python bin/

## Web server

If package is installed via pip, you need a file named containing somehwhere on local server:

def worker_exit(server, worker):
from prometheus_client import multiprocess multiprocess.mark_process_dead(

If you cloned the repository and installed it via python install, just refer to the in the cloned repository.

export BIOMAJ_CONFIG=path_to_config.yml rm -rf ..path_to/prometheus-multiproc mkdir -p ..path_to/prometheus-multiproc export prometheus_multiproc_dir=..path_to/prometheus-multiproc gunicorn -c ..path_to/ biomaj_download.biomaj_process_web:app

Web processes should be behind a proxy/load balancer, API base url /api/process

A prometheus /metrics endpoint is exposed on web server

In case of proxy comm failure, sleep a few seconds before retry
Add proc name in logs for waiting and result
Add env var BIOMAJ_HOST_DATA_DIR to use with docker process executor to specify data.dir location if different between host and container (if BIOMAJ_DATA_DIR not a subdirectory of BIOMAJ_DIR for example)
If variable is not set, container wil mount data.dir between host and container, else will mount BIOMAJ_HOST_DATA_DIR:data.dir
Fix traefik prefix
Update pika dependency release Add tags for traefik support
Catch exception for microservices if remote server is not reachable Rename package for protobuf to avoid collisions
README doc fixes Add dependency banks additional volumes for Docker
Allow local_endpoint definition per service Fix volumes for docker with dependency banks
Fix #1, DRMAA needs colon in front of output and error path (mandatory depending on versions)
fix case if process desc or type is missing in bank properties
disable web thread logging
retry in case of contact failure with proxy
for docker, restrict directory to bank directory and dependencies add host in prometheus stats
fix prometheus + gunicorn multi process add consul supervision
add logging info execute docker processes in biomaj micro service
bug fixes
move process management out of biomaj main package

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for biomaj-process, version 3.0.16
Filename, size File type Python version Upload date Hashes
Filename, size biomaj_process-3.0.16-py2.py3-none-any.whl (27.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size biomaj_process-3.0.16.tar.gz (14.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page