Skip to content

Latest commit

 

History

History
166 lines (100 loc) · 6.1 KB

File metadata and controls

166 lines (100 loc) · 6.1 KB

Working with Apps on INCLUDE Data Hub

We now will explore how to use your own and public apps in your project workspace

In your browser navigage to https://includedcc.org/

Proceed through the following steps:

  1. Initial login through the INCLUDE Data Hub:

  1. Login with google or ORCID

Here is an example of logging in with ORCID

Your landing page is the dashboard - from there you can login to CAVATICA

Alternatively - Head Straight to CAVATICA

In your browser navigate to "https://cavatica.sbgenomics.com"

Login here:

You are then in an environment where you can see a number of things including public and developer tabs

Developer Authentication Token

As in all things these days, to push or at times use (if your application is private) applications you have in the repository - you will need to authenticate with your personal authentication token. You should not share your token with others.

Copying Public Apps to your Project

To use an application within your project, you need to copy that application to your project

In this example, the user navigated through the public apps looking for the FastQC analysis application and copied it to the Elements of Style project workspace.

Using the application

Data are required and the same files that were used in the Nextflow workflow example were copied up onto the CAVATICA workspace.

Then the analysis was run and we can view the resulting files in the same way that you can view the results of the execution example ran on the Google Shell Cloud -- but we are in a workspace now where we can have a large number of machines running in parallel. There are limits of course, and depending upon the analysis these limits can be discussed -- because the important things is to get the Science done properly and efficiently.

Navigate to Elements of Style Project Workspace

You all have been invited into my project workspace so that you can have access to the items and work that we walked through today.

Inspect the tabs and head to the Task Tab

You can also head over and see what tasks have been run (both successful and unsuccessful)

So how to load your own App

We just illustrated how to build your single process container with Docker within the Google Shell environment.

With every container there are three steps

  1. Build - done with:
docker build -t my-tag .
  1. Tag

If the image is not tagged with the appropriate name for the destination registry, you have to tag it again.

docker tag [image] [pgc-images.sbgenomics.com/deslattesmaysa2/fastqc:v1.0
  1. Push

To be used the image needs to be in a repository.

This is how the apps were tagged here:

Before you can create a location for the app you need an Authentication Token

This bears repeating as all the work is done with the Authentication Token

Before you can do the Push step, you will also need to know how to login.
The CAVATICA platform makes it pretty easy, you have to copy the commands to allow you to authenticate with your user name and your personal authentication token

docker login pgc-images.sbgenomics.com -u deslattesmaysa2 -p [personal authentication token]

Before we upload an app we need to create a space for it

In order to push your image to the repository, the repository location needs to exist.

And then create the repository location for its eventual resting place

All the commands for Tagging, Pushing and Pulling are provided for you

CAVATICA makes it fairly easy to succeed in putting your own applications on their site.



Return to the Agenda

Main Agenda

Additional resources: