Duke-GCB/MMAP-Docker

Name: MMAP-Docker

Owner: Duke Center for Genomic and Computational Biology

Description: Docker images for containerizing MMAP

Created: 2015-03-05 18:07:45.0

Updated: 2016-07-09 20:24:28.0

Pushed: 2016-07-09 20:36:42.0

Homepage: null

Size: 6013

Language: Shell

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Dockerfiles for MMAP

This directory contains Dockerfiles for building Docker images, encapsulating steps of the MMAP analysis pipeline into containers.

Each image implements a step in the pipeline, and should be treated as a single command. Parameters are sent to the containers by setting environment variables, taking cues from bioboxes.

Images

See README.md in each subdirectory for further details.

To-Do
Usage notes

These images are designed to be run within docker-pipeline, and treated as simple Unix-style command-line tools. Information is passed to container execution by configuring volumes and setting environment variables. For example:

# Running genovo to assemble reads into contigs
docker run \
  -v /Users/dcl9/Data/reads:/mnt/input:ro \
  -v /Users/dcl9/Data/contigs:/mnt/output \
  -e CONT_INPUT_READS_FILE=/mnt/input/reads.fasta \
  -e CONT_OUTPUT_CONTIGS_FILE=/mnt/output/contigs.fasta \
  -e CONT_INPUT_ASSEMBLE_ITERATIONS=10 \
  dleehr/genovo

Note that the input volume is mounted read-only, and the file paths passed in the environment variables are paths from inside the container.

The environment variables are validated and interpreted by simple wrapper scripts inside the image, which execute the underlying command. These scripts are configured as the image's CMD, allowing each image to be treated like a Unix-style command-line tool.

The wrapper scripts output the commands they will execute, as well as underyling tool versions.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.