Metadata-Version: 2.1
Name: rekcurd-dashboard
Version: 1.0.1.post6
Summary: A WebUI for managing machine learning services of Rekcurd.
Home-page: https://github.com/rekcurd/dashboard
Author: Rekcurd team and contributors
Author-email: 
License: Apache License Version 2.0
Keywords: Rekcurd,Kubernetes,Python,gRPC,Restful
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: Flask (==1.0.3)
Requires-Dist: Flask-Cors (>=3.0.4)
Requires-Dist: grpcio (>=1.22.0)
Requires-Dist: grpcio-tools (>=1.22.0)
Requires-Dist: python-json-logger (>=0.1.9)
Requires-Dist: fluent-logger (>=0.9.3)
Requires-Dist: PyYAML (>=3.12)
Requires-Dist: SQLAlchemy (>=1.2.7)
Requires-Dist: PyMySQL (>=0.8.0)
Requires-Dist: flask-sqlalchemy (>=2.3.2)
Requires-Dist: kubernetes (<10.0.0,>=v8.0.0)
Requires-Dist: flask-restplus (>=0.11.0)
Requires-Dist: Flask-Testing (>=0.7.1)
Requires-Dist: Flask-JWT-Simple (>=0.0.3)
Requires-Dist: python-ldap (>=3.1.0)
Requires-Dist: Flask-Migrate (>=2.2.1)
Requires-Dist: Flask-Script (>=2.0.6)
Requires-Dist: protobuf3-to-dict (>=0.1.5)
Requires-Dist: boto (>=2.49.0)
Requires-Dist: boto3 (>=1.9.38)
Requires-Dist: urllib3 (>=1.24.2)

# Rekcurd-dashboard

[![Build Status](https://travis-ci.com/rekcurd/dashboard.svg?branch=master)](https://travis-ci.com/rekcurd/dashboard)
[![PyPI version](https://badge.fury.io/py/rekcurd-dashboard.svg)](https://badge.fury.io/py/rekcurd-dashboard)
[![codecov](https://codecov.io/gh/rekcurd/dashboard/branch/master/graph/badge.svg)](https://codecov.io/gh/rekcurd/dashboard "Non-generated packages only")
[![pypi supported versions](https://img.shields.io/pypi/pyversions/rekcurd-dashboard.svg)](https://pypi.python.org/pypi/rekcurd-dashboard)

Rekcurd dashboard is the project for managing ML model and deploying ML module. Any Rekcurd service is manageable. It can deploy the Rekcurd service to Kubernetes cluster and can control traffic weights which Istio manages.


## Parent Project
https://github.com/rekcurd/community


## Components
- [Rekcurd](https://github.com/rekcurd/rekcurd-python): Project for serving ML module.
- [Rekcurd-dashboard](https://github.com/rekcurd/dashboard): Project for managing ML model and deploying ML module.
- [Rekcurd-client](https://github.com/rekcurd/python-client): Project for integrating ML module.


## Screen shot
<img src="./docs/img/application-dashboard.png" width="480">


## Environment
- Python 3.6
- flask 1.0.x
- [Node.js](https://nodejs.org/) 8.x
- [yarn](https://yarnpkg.com/)


## Installation
From source:

```bash
$ git clone --recursive https://github.com/rekcurd/dashboard.git
$ cd dashboard/frontend
$ yarn install && yarn run build && cd ..
$ pip install -e .
```

From PyPi directly:

```bash
$ pip install rekcurd-dashboard
```


## How to use
Check the belows in detail.
- [Backend](./rekcurd_dashboard/README.md)
- [Frontend](./frontend/README.md)

##### Generate settings
You can generate the template of `settings.yml` file.
```bash
$ rekcurd_dashboard template
```

##### Boot command
```bash
$ rekcurd_dashboard db --settings settings.yml init
$ rekcurd_dashboard db --settings settings.yml migrate
$ rekcurd_dashboard server --settings settings.yml
```

##### docker-compose (Deprecated)
```bash
# For dev
$ docker-compose -f docker-compose/docker-compose.develop.yaml up
# For prod
$ docker-compose -f docker-compose/docker-compose.production.yaml up
```

##### For AWS users
If you run this on AWS (such as EKS), you need to configure aws-cli setting.  
Follow the [official document](https://docs.aws.amazon.com/streams/latest/dev/kinesis-tutorial-cli-installation.html).  

**Rekcurd-dashboard docker container will mount the configuration files,  
so the IAM account used by configuration needs to have enough permissions to access to Kubernetes resources on AWS.**

```bash
# For dev
$ docker-compose -f docker-compose/aws/docker-compose.develop.yaml up
# For prod
$ docker-compose -f docker-compose/aws/docker-compose.production.yaml up
```

## How to use WebUI
See [docs](./docs/README.md) in detail.


## Test
### Unittest
```bash
$ python -m unittest test/*/test_*
```

### e2e test
```bash
## sudo sh scripts/kube-init.sh
$ sudo sh e2e_test/startup.sh
$ python -m unittest
$ sudo sh e2e_test/cleanup.sh
```


## Kubernetes support
Rekcurd can be run on Kubernetes. See [community repository](https://github.com/rekcurd/community).


