Skip to main content

Distributed job execution application built for Galaxy (http://galaxyproject.org/).

Project description

https://readthedocs.org/projects/pip/badge/?version=latest https://travis-ci.org/galaxyproject/pulsar.png?branch=master https://coveralls.io/repos/galaxyproject/pulsar/badge.png?branch=master

This project is a Python server application that allows a Galaxy server to run jobs on remote systems (including Windows) without requiring a shared mounted file systems. Unlike traditional Galaxy job runners - input files, scripts, and config files may be transferred to the remote system, the job is executed, and the results are transfered back to the Galaxy server - eliminating the need for a shared file system.

Full documentation for the project can be found on Read The Docs.

Configuring Galaxy

Galaxy job runners are configured in Galaxy’s job_conf.xml file. Some small examples of how to configure this can be found here, but be sure to checkout job_conf.xml.sample_advanced in your Galaxy code base or on Github for complete information.

Quickstart

Full details on different ways to install Pulsar can be found in the install section of the documentaiton, but if your machine has the proper Python dependencies available it can be quickly download and a test job run with.

mkdir pulsar
cd pulsar
virtualenv venv
. venv/bin/activate # .venv\Scripts\activate if Windows
pip install pulsar-app
pulsar-config
pulsar --daemon # just pulsar if Windows
pulsar-check # runs a test job

The configuration documentation has many details on securing your Pulsar server and enabling advanced features such as cluster integration and message queue communication.

Development and Testing

The recommended approach to setting up a development environment for Pulsar on Linux or Mac OS X is rougly as follows:

git clone https://github.com/galaxyproject/pulsar
cd pulsar
virtualenv .venv
. .venv/bin/activate # .venv\Scripts\activate if Windows
pip install -r requirements.txt
pip install -r dev-requirements.txt

This project is distributed with unit and integration tests (many of which will not run under Windows), the following command will install the needed python components to run these tests. The following command will then run these tests:

make tests

The following command will then produce a coverage report corresponding to this test and place it in the coverage_html_report subdirectory of this project.:

coverage html

Checkout the Contributing documentation for many more details on developing and contributing to Pulsar.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

History

0.4.0 (2015-04-20)

  • Python 3 support. Pull Request 62

  • Fix bug encountered when running pulsar-main and pulsar-config commands as scripts. 9d43ae0

  • Add pulsar-run script for issues commands against a Pulsar server (experimental). 3cc7f74

0.3.0 (2015-04-12)

  • Changed the name of project to Pulsar, moved to Github.

  • New RESTful web services interface.

  • SCP and Rsync file staging options added by Eric Rasche. Pull Request

  • Allow YAML based configuration.

  • Support for more traditional pip/setup.py-style installs.

  • Dozens of smaller bugfixes and documentation updates.

0.2.0

  • Last version named the LWR - found on BitBucket.

  • Still supported in Galaxy as of 15.03 the release.

  • Introduced support for submitting to various queueing systems, operation as a Mesos framework, Docker support, and various other advanced deployment options.

  • Message queue support.

  • Framework for configurable file actions introduced.

0.1.0

0.0.1

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pulsar-app-0.4.0.tar.gz (169.3 kB view details)

Uploaded Source

Built Distributions

pulsar_app-0.4.0-py2.7.egg (492.5 kB view details)

Uploaded Source

pulsar_app-0.4.0-py2-none-any.whl (210.2 kB view details)

Uploaded Python 2

File details

Details for the file pulsar-app-0.4.0.tar.gz.

File metadata

  • Download URL: pulsar-app-0.4.0.tar.gz
  • Upload date:
  • Size: 169.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pulsar-app-0.4.0.tar.gz
Algorithm Hash digest
SHA256 6b69ff448e8cbf5c0d3f217d52aec4134d31877a055b5519a62d4ea1020f7fc2
MD5 f702c2573afb423d68c36ae0e4906956
BLAKE2b-256 c7830ba2a287e45832a4f025ba05a813eb828986de57b96f5e1df9a631344d41

See more details on using hashes here.

File details

Details for the file pulsar_app-0.4.0-py2.7.egg.

File metadata

File hashes

Hashes for pulsar_app-0.4.0-py2.7.egg
Algorithm Hash digest
SHA256 f061bd4b80f6d851a8d59ba50f6ccdd0a7764f79aa35ff1113c10a5e2d19c31a
MD5 2c1cfddf40006c6c5b9936c6dc7fe9b2
BLAKE2b-256 40b66839802316f41e4532a7fac64b704fc4dc0e07d0853a2a896fa429317803

See more details on using hashes here.

File details

Details for the file pulsar_app-0.4.0-py2-none-any.whl.

File metadata

File hashes

Hashes for pulsar_app-0.4.0-py2-none-any.whl
Algorithm Hash digest
SHA256 76798ad6eed386b0fa83581052b1a9e504b721b27959f2b6fd5aed4340f6d901
MD5 156c2729ec6466670a8775438bbb4db4
BLAKE2b-256 fc21ed2097d9671de9a16466da4db60456ed6a487e973d3399b9efaacb17ff92

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page