2016-12-02 22:13:25 +03:00
# BatchLabs
2016-12-02 22:34:09 +03:00
[![Build Status ](https://travis-ci.org/Azure/BatchLabs.svg?branch=master )](https://travis-ci.org/Azure/BatchLabs)
2016-12-05 20:40:41 +03:00
2017-09-21 08:27:40 +03:00
**Note: BatchLabs is in preview.**
2016-12-05 20:40:41 +03:00
2017-04-03 22:13:39 +03:00
2017-05-22 21:11:09 +03:00
## Description
2017-06-20 20:30:48 +03:00
Batch Labs is a tool to manage your Azure Batch accounts. The goal is to implement a great user experience that will help you debug, monitor and manage your pools, jobs and tasks.
It will also include expermiental features such as `Batch Templates` in the aim to improve your Batch experience. We are open to any feedback, ideas and contributions you might have.
2017-05-22 21:11:09 +03:00
2017-09-21 08:27:40 +03:00
![](docs/images/job-home.png)
## Downloads
You can download the latest version at https://github.com/Azure/BatchLabs/releases
## Building batchlabs yourself
2017-03-23 01:04:03 +03:00
#### 1. Prerequisites
2017-04-25 21:14:34 +03:00
- **Install node.js version `6.9` or greater. [Download ](https://nodejs.org/en/download/ )**
2017-07-18 18:57:21 +03:00
- Install python **3.6** (doesn't need to be in the path if that breaks your environment)
2016-12-15 01:31:59 +03:00
2017-03-23 01:04:03 +03:00
#### 2. Clone the repo
2017-03-22 01:56:56 +03:00
- At stable branch `git clone -b stable https://github.com/Azure/BatchLabs`
- Or for the latest changes `git clone https://github.com/Azure/BatchLabs`
2016-12-02 22:08:53 +03:00
2017-05-22 21:11:09 +03:00
Move to the directory `cd BatchLabs`
2017-08-17 00:38:39 +03:00
#### 3. Build the app with all in one command line(Windows only)
Call this command and it will check you have everything setup correctly and build the app.
```
.\scripts\install\install-windows
```
**You can skip all the other steps**
#### 4. Install the dependencies
2017-03-28 00:12:36 +03:00
```bash
2017-08-17 00:38:39 +03:00
npm install -g yarn
2017-03-23 01:04:03 +03:00
yarn install
2017-07-28 18:57:51 +03:00
pip3 install -r python/requirements.txt # or pip if on windows or only have python 3.6 installed
2016-12-02 22:08:53 +03:00
```
2017-06-20 20:30:48 +03:00
Note: You can also use `npm install` at your own risk. However please do not submit an issue if you didn't use `yarn install` . Yarn will make sure you have the right set of dependencies, which reduces the likelihood of any unexpected build issues relating to third party packages.
2016-12-02 22:08:53 +03:00
2017-08-17 00:38:39 +03:00
#### 4.5 Setup some configuration(Only in certain case)
2017-07-18 18:57:21 +03:00
If you didn't installed python in the path you will need to let batchlabs know where it is.
Set an environment variable called `BL_PYTHON_PATH` with that path to the python executable.
Batchlabs will look first to see if this environemnt variable is set if not try `python3` and then `python` to find an installation of python 3.6
2017-08-17 00:38:39 +03:00
#### 5. Build and run the application
2017-03-28 00:12:36 +03:00
```bash
2017-07-18 18:57:21 +03:00
# Make an executable, this will bundle all needed dependencies including node and python
2017-05-24 00:56:40 +03:00
npm run build-and-pack
# Manual
2017-03-22 18:22:30 +03:00
npm run build:prod
npm run electron:prod
# To debug errors
2016-12-16 21:42:19 +03:00
npm run build
npm run electron
```
## Developers
2017-01-27 03:10:28 +03:00
[Dev docs ](docs/readme.md )
2017-04-05 21:56:07 +03:00
## License
Batch labs is licensed under MIT [See license ](LICENSE )
Some icons are under Creative Commons Attribution-ShareAlike 3.0 Unported [See license ](app/assets/images/logos/LICENSE )