https://github.com/nds-org/ndslabs
Main repository for the National Data Service Labs initiative.
https://github.com/nds-org/ndslabs
labs-workbench
Last synced: 6 months ago
JSON representation
Main repository for the National Data Service Labs initiative.
- Host: GitHub
- URL: https://github.com/nds-org/ndslabs
- Owner: nds-org
- License: bsd-3-clause
- Created: 2016-03-24T18:53:27.000Z (about 9 years ago)
- Default Branch: develop
- Last Pushed: 2024-01-11T23:02:11.000Z (over 1 year ago)
- Last Synced: 2024-08-07T03:15:20.362Z (10 months ago)
- Topics: labs-workbench
- Language: Shell
- Homepage: http://www.nationaldataservice.org
- Size: 35.8 MB
- Stars: 8
- Watchers: 6
- Forks: 9
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-open-research - NDS Labs code
README
# NDS Labs
[](https://gitter.im/nds-org/ndslabs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 
This is the main repository for the [National Data Service](http://www.nationaldataservice.org/) [Labs Workbench](http://www.nationaldataservice.org/platform/workbench.html) service.
Labs Workbench is an experimental space for evaluating, developing, and exploring interoperability between research data management services. This is achieved through the use of applications containerized with [Docker](https://www.docker.com/what-docker), [Kubernetes](http://kubernetes.io/docs/whatisk8s/) for container orchestration, deployed on an [OpenStack](https://www.openstack.org/) cluster.
For more information, see the [architecture documentation](https://opensource.ncsa.illinois.edu/confluence/display/NDS/Workbench+Architecture).
On top of this foundation, NDS Labs provides a user interface, command line interface, and an API server used to manage the configuration and deployment of containerized services. This repository includes documentation for the platform, as well as references to the following:
* helm-chart: Instructions and templates for deploying Workbench to a Kubernetes cluster
* specs: Catalog of containerized services offered by the Workbench platform
* apiserver: REST API server, a thin management layer over etcd and Kubernetes as well as the ndslabsctl command line utility
* webui: Project management UI implemented in AngularJS
## Helm Chart
The Labs Workbench offers a `helm-chart` to ease deployment to a Kubernetes cluster.
The [workbench-helm-chart](https://github.com/nds-org/workbench-helm-chart) repository offers steps to:
* Deploy a Kubernetes cluster
* Prepare your cluster to run the Labs Workbench platform
* Deploy pre-built containers to run Workbench in your cluster
## Service Catalog
The Labs Workbench includes a catalog of service specifications (`specs`) managed via
the [ndslabs-specs](https://github.com/nds-org/ndslabs-specs) repository. The catalog currenty contains over 50 services (and growing).
## API Server and Web UI
The two main components of the Workbench platform are the `apiserver` and the `webui`.
The [workbench-apiserver-python](https://github.com/nds-org/workbench-apiserver-python) and [workbench-webui](https://github.com/nds-org/workbench-webui) have their own source repositories.
## Documentations
The `apis` and `docs` directories contain instructions for generating the documentation for the platform.
* `apis`: Swagger documentation about the REST API offered by Workbench
* `docs`: Sphinx documentation about general platform usage
# Resources
The Labs Workbench is a hosted service and is not intended for installation. For Labs Workbench developers, it is possible to run the complete system on a single virtual machine or laptop.
* To run a development copy of Labs Workbench, see https://github.com/nds-org/workbench-helm-chart
* To deploy Kubernetes Terraform on an OpenStack cluster, see https://github.com/nds-org/kubeadm-terraform
# Where to Get Help
* [NDS Wiki](https://nationaldataservice.atlassian.net/wiki/display/NDSC/NDS+Labs+Workbench)
* [File an issue](https://github.com/nds-org/ndslabs/issues)
* [NDS Labs Google Group](https://groups.google.com/forum/#!forum/ndslabs/)
* [Find us on Gitter](https://gitter.im/nds-org/ndslabs)
# Contributing
For more information on our Developer Workflows, see [Developer Workflows](https://opensource.ncsa.illinois.edu/confluence/display/NDS/Developer+Workflows).
In short, fork this repository and make a pull request. We will review and give feedback.