Public | Automated Build

Last pushed: 6 months ago
Short Description
Minimal base image with bioboxes software installed
Full Description

biobox minimal base image

About

This is contains a minimal debian base image for creating bioboxes. This
bundles software which can make the verification and argument parsing steps of
running a biobox easier. The included software are:

  • validate_inputs.sh - used to ensure the biobox.yaml given to the
    container is correct. This is run as the ENTRYPOINT directive in the
    Dockerfile. After checking the biobox.yaml file the script named by the
    BIOBOX_EXEC environment variable in the developer's Dockfile is called.

  • fetch_archive.sh - Given a URL and a name, fetches the URL and
    decompresses it to a directory under /usr/local with the given name.

  • biobox_args.sh - Fetches the biobox.yaml arguments and then applies a
    given jq path. An example of fetching fastq paths is:

    biobox_args.sh 'select(has("fasta")) | .fasta | map(.value)'
    

Using

Developing bioboxes using the bioboxes minimal base image requires creating a
executable script inside the image and setting the environment variable
BIOBOX_EXEC. This script will be executed by the validate_inputs.sh script
after checking the biobox.yaml file is valid. The follow environment variables
will also be set and are recommended to be used:

  • INPUT The location of the biobox.yaml file mounted in the container.
  • OUTPUT The location of the output directory where generated files
    should be placed, including a new biobox.yaml describing the generated
    outputs.
  • METADATA A directory for storing logs and other metadata.
Docker Pull Command
Owner
bioboxes
Source Repository