00mjk / cloud-interop-ui

Manage Cloud interoperability test plugins and schedules through web interface

GA4GH Testbed Orchestrator UI

This repository contains the UI-tier for the GA4GH Testbed Orchestrator. The UI allows users to create and modify:

• Plugins: Reusable modules/blueprints that can be executed on different GA4GH services using different input parameters
• Configurations: Runs Plugin code against a specific service (or set of services) at scheduled intervals, generating a Report each time.

Generated Reports can also be viewed via the UI.

Getting Started

Prerequisites

Currently, the Orchestrator UI requires the following to be installed on your system:

• Node.js - Orchestrator UI is built with v10.16.3
• npm - Orchestrator UI is built with 6.11.3
• MongoDB - Orchestrator UI is built 4.0.3
• Optional - consider using nvm (node virtual manager) to handle multiple versions of Node.js/npm

Installation and Usage

MongoDB

The Orchestrator UI connects to the mongo daemon (mongod) running locally on the default port 27017. Ensure that the daemon is running, and that the local user has write access to the ga4gh_testbed database.

Installation

With the above installed, issue the following commands to:

1. Download Orchestrator UI source from Github
2. Download dependencies from npm
3. Build and Run web service

git clone https://github.com/ga4gh/cloud-interop-ui.git
npm install
npm run all

Usage

In a browser window, navigate to http://localhost:3000, you should see the Orchestrator UI home page.

Technology Stack

• Node.js - JavaScript runtime
• npm - dependency management
• webpack - builds distribution code from source
• MongoDB - database to store Plugins, Configurations, Reports
• Express.js - JavaScript-based server-side web framework
• React - front-end, user-interface framework

Issues

Please raise any issues on Github