Summary

This plugin implements the support for GA4GH APIs for Nextflow.

It currently only supports the Task Execution Service (TES) API.

The Task Execution Schema (TES) project by the GA4GH standardization initiative is an effort to define a standardized schema and API for describing batch execution tasks in a portable manner.

Get Started

To use this plugin, add it to your nextflow.config:

plugins {
    id 'nf-ga4gh'
}

Configure the TES executor:

process.executor = 'tes'

Configure the endpoint and authentication:

tes {
    endpoint = 'http://localhost:8000'
    timeout = 30
    pollInterval = '10s'
}

[!NOTE]

While the TES API is designed to abstract workflow managers from direct storage access, Nextflow still needs to access the shared work directory used by your TES endpoint.

For example, if your TES endpoint is located in Azure and uses Azure Blob storage to store the work directory, you still need to provide the necessary Azure credentials for Nextflow to access the Blob storage.

Examples

Basic Configuration

plugins {
    id 'nf-ga4gh'
}

process {
    executor = 'tes'
    container = 'quay.io/nextflow/bash'
}

tes {
    endpoint = 'http://localhost:8000'
    timeout = 30
    pollInterval = '10s'
    
    tags {
        tag1 = 'abc'
        tag2 = 'xyz'
    }
}

Authentication - Basic

tes {
    basicUsername = '<username>'
    basicPassword = '<password>'
}

Authentication - API Key

tes {
    apiKeyParamMode = 'header'
    apiKeyParamName = 'Authorization'
    apiKey = '<key>'
}

Authentication - OAuth

tes {
    oauthToken = '<token>'
}

Local TES Server Setup

curl -fsSL https://ohsu-comp-bio.github.io/funnel/install.sh | bash

funnel server run

License

Apache License 2.0