Gito - A Docker image based on research software good practices for building containers of bioinformatics software
Gito is a lightweight and safe Docker image based on Alpine containing bioinformatics tools ready to be used. It's an open source project that provides an easy and modular method for building, distributing and replicating pipelines, those of which hava a base image that forms the foundation layer on which each container is built. The base image is only 4.41 MB in size and contains only the OS libraries and language dependencies required to run the tools, but robust enough to run bioinformatics pipelines with security.
Gito was conceived with the "start with the minimum and add dependencies as needed" philosophy in mind, meaning we encourage separate containers for each bioinformatics tool configured with the minimum to run. Gito uses musl libc as the standard C library for Linux-based systems. Musl libc is free, lightweight, security-oriented and smaller in size compared to the Glibc library. The source codes for bioinformatics tools, written in C, C++ and Java, have been compiled for native Alpine executables.
Guide to downloading and running this Docker image
Step 1: Install Docker
To download and run this Docker image, you first need to set up Docker on your machine. The easiest way to start with Docker is to install the Docker Desktop (https://www.docker.com/products/docker-desktop) by simply downloading and clicking the installer which is available for both Mac OSX and Windows. For Linux users, follow the instructions here, and to use the CLI without sudo
, follow the post-installation steps.
Step 2: Download and run the Docker image
The image can be downloaded and executed through the Docker CLI with the following commands:
-
Pull (download) the Docker images:
$ docker pull gitobioinformatics/fastqc
$ docker pull gitobioinformatics/trimmomatic
$ docker pull gitobioinformatics/trinity
$ docker pull gitobioinformatics/bowtie2
-
Change the working directory to a project and run the following commands:
-
FastQC
$ docker run -u $(id -u):$(id -g) -v $PWD:/data -w /data --rm gitobioinformatics/fastqc
-
Trimmomatic
$ docker run -u $(id -u):$(id -g) -v $PWD:/data -w /data --rm gitobioinformatics/trimmomatic
-
Trinity
$ docker run -u $(id -u):$(id -g) -v $PWD:/data -w /data --rm gitobioinformatics/trinity
-
Bowtie2
$ docker run -u $(id -u):$(id -g) -v $PWD:/data -w /data --rm gitobioinformatics/bowtie2
-
Deploy this Docker image onto your cloud
You can download and deploy this Docker image with your cloud provider such as DigitalOcean, Amazon Web Services, HP Enterprise, IBM, Microsoft Azure Cloud or others.
Reproducing a pipeline example
Gito was used to reproduce the pipeline present in the work of Hernández-Fernández (2017), which is the first de novo transcriptome assembly of Eretmochelys Imbricate published. Instructions used and execution results can be accessed here.
Building a Gito image from the source
To build Gito images from the source, you can use the following process:
-
Install latest version of Docker:
For Linux users, you can follow the instructions here to manage Docker as non-root user. Otherwise, execute
gitobld
script usingsudo
. -
Get the source code:
$ git clone https://github.com/gitobioinformatics/gito.git $ cd gito
-
Create a private and public key to sign the apk packages:
$ mkdir -p keys $ openssl genrsa -out keys/packager_key.rsa 2048 $ openssl rsa -in keys/packager_key.rsa -pubout -out keys/packager_key.rsa.pub
-
Run the helper script to build the images:
$ ./gitobld build -rS all
If you are using
sudo
to execute, use the following command:$ sudo ./gitobld build -U $(id -un) -rS all
You can build individual images by using the tool name instead of
all
.
Directory structure
Directory | Description |
---|---|
base | Contains Dockerfile used to build Gito base image. |
build | Utilities to create Docker images using Gito as base. |
examples | Contains examples of bioinformatics pipelines using Gito images. |
images | Contains images used by this README. |
library | Dockerfiles used to build several tools using Alpine packages from ports directory. |
ports | Contains APKBUILD files for bioinformatic tools. |
Security and vulnerabilities
Due to the extremely small size, Gito has a smaller attack surface compared to the containers that are based on larger images. To assess safety, we used Quay Security Scanner to assess vulnerabilities in Gito. Quay identifies insecure packages by matching the metadata against Common Vulnerabilities and Exposures (CVE) database. The results of the analysis were published in the Quay portal, and the scanning of each tool can be accessed below:
Image | Scanning Result |
---|---|
Bowtie2 | |
FastQC | |
Jellyfish | |
Prokka | |
Salmon | |
Samtools | |
SPAdes | |
SRA Tools | |
Trimmomatic | |
Trinity |
License
MIT License. See LICENSE for more information
Contributions
Gito is open-source (see LICENSE), and we welcome contributions from anyone who is interested in contributing. To contribute, please make a pull request. The issue tracker for Gito is also available on GitHub.
Inspirations
The word "gito" is used by people from the North of Brazil when they refer to something "very small, smaller than normal". The logo of the project was inspired by the tucuxi (Sotalia fluviatilis), which is one of the smallest dolphins of the Delphinidae family and the only one of this family that lives in the rivers. It is a very agile dolphin and although it is an endangered species, it is still possible to find it in Amazonian rivers jumping in the air.
Acknowledgements
We thank the following institutions, which contributed to ensuring the success of our work:
Ministério da Ciência, Tecnologia, Inovação e Comunicação (MCTIC)
Museu Paraense Emílio Goeldi (MPEG)
Universidade Federal do Pará (UFPA)
Centro Universitário do Estado do Pará (CESUPA)
Funding
This work has been supported by Conselho Nacional de Desenvolvimento Científico e Tecnológico - CNPq (grants 149985/2018-5; 129954/2018-7).
Authors
Marcos Paulo Alves de Sousa
Franklin Gonçalves Sobrinho
Lucas Peres Oliveira
Kayke Correa Conceição Lins Pereira
Contact
Dr. Marcos Paulo Alves de Sousa (Project leader)
Email: [email protected]
Laboratório de Biologia Molecular
Museu Paraense Emílio Goeldi
Av. Perimetral 1901. CEP 66077- 530. Belém, Pará, Brazil.