phnmnl / container-galaxy-k8s-runtime

PhenoMeNal runtime for Galaxy running inside a container orchestrator
Apache License 2.0
5 stars 18 forks source link

Logo

Galaxy

Version: 18.01-pheno

Short Description

Galaxy is an open, web-based platform for data intensive biomedical research.

Description

Increased reliance on computational approaches in the life sciences has revealed grave concerns about how accessible and reproducible computation-reliant results truly are. Galaxy http://usegalaxy.org, an open web-based platform for genomic research, addresses these problems. Galaxy automatically tracks and manages data provenance and provides support for capturing the context and intent of computational methods. Galaxy Pages are interactive, web-based documents that provide users with a medium to communicate a complete computational analysis.

This PhenoMeNal version of Galaxy is a container capable of running inside the Kubernetes container orchestrator, and able to schedule Kubernetes jobs from the inside of the cluster. It is a lighweight container as no toolshed dependencies are needed. The current version extends Galaxy 18.01 with the following:

The Galaxy - Kubernetes integration and Galaxy helm charts are contributions made entirely by the PhenoMeNal Project to the Galaxy Project.

This release version uses the tools listed in this table, tagged at the specified release versions.

Note: maintainers are for containers, not necessarily tool authors. Follow links to learn about tool authors.

Key features

Functionality

Approaches

Instrument Data Types

Screenshots

Tool Authors

Container Contributors

Website

Git Repository

The repository refers to some submodules. To check it out completely use the --recurse-submodules option with git clone:

git clone --recurse-submodules  https://github.com/phnmnl/container-galaxy-k8s-runtime.git

If you later want to pull latest version and also pull latest submodule updates:

git pull --recurse-submodules
git submodule update --recursive --remote

Installation

This Galaxy deployment will be available at all PhenoMeNal CRE deployments (cloud, bare-metal, development, etc), which can be created through the PhenoMeNal Portal or by using more advanced methods.

If you want to install it locally as a docker container:

docker pull container-registry.phenomenal-h2020.eu/phnmnl/galaxy-k8s-runtime

However, please note that this image is not entirely functional without running inside or connected somehow to a Kubernetes cluster.

If you have a Kubernetes cluster (or a Minikube instance), it can be deployed through Helm:

# first time only
helm repo add galaxy-helm-repo https://pcm32.github.io/galaxy-helm-charts
# and then everytime you want to deploy
helm install galaxy-helm-repo/galaxy

This helm chart accepts plenty of options, and there is also another helm chart for production deployment with more options. For more details see this link or the helm repo for Galaxy.

Usage Instructions

On PhenoMeNal CRE deployments, you will be given a link if deployed through the PhenoMeNal Portal. The instance will be secured for the email and password that you provided during setup.

To use it at the PhenoMeNal Public instance you will need to register through the PhenoMeNal Portal, by clicking on "Create your cloud research environment", sign-in through the Elixir Single-sign-on with your Google or institutional account, and then choose "PhenoMeNal Cloud", where you will be able to create an account for the public instance.

If deployed locally on Minikube using Helm, most likely you access URL will be http://192.168.99.100:30700. This could vary if the internal Minikube IP is different (although port should be the same).

For direct docker usage: this image is not meant to be used directly with docker only.

Publications