# Juice

**Repository Path**: mirrors_gspandy/Juice

## Basic Information

- **Project Name**: Juice
- **Description**: A Distribution Task Management System
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Why Juice

Juice is a set of distributed task scheduling cloud system based on Mesos Framework developed by Hujiang Learning Management System group (LMS). Based on this system you can realize the scheduling of any job task.

Time-consuming computing tasks in Hujiang is a continuous demand. Such as multimedia transcoding, Map Reduce, intensive computing and so on. Each working team were do their own before Juice, do the development of different task processing systems, not only consuming the manpower, but also consuming the server.

Juice uses Mesos clustered idle computing capabilities, responsible for a unified interface return and task query function, the advantages are as follows:

* Based on the Mesos cluster, the maximum use of idle resources to complete time-consuming calculation
* Asynchronous scheduling, and provide results query and callback to obtain the results of the implementation
* Distributed management, all time-consuming tasks are stateless in resource pools.
* Task query, currently opened the interface for query task status and results.

##### Latest Release Version:1.0-OPEN

## Getting Started

##### Requirements

* [Mesos](http://mesos.apache.org/gettingstarted/)
* [ZooKeeper](https://zookeeper.apache.org/doc/r3.4.6/zookeeperStarted.html)
* Java8
* [MySql](https://dev.mysql.com/doc/mysql-getting-started/en/)
* [Redis](https://redis.io/)
* [Marathon](https://mesosphere.github.io/marathon/)(optional)
* [Docker](https://www.docker.com/)

## Install

* Install the Zookeeper cluster
* Install the Mesos cluster and join the Zookeeper cluster.

~~~~
  Add Zookeeper's address to the configuration file of project:

  juice-service/src/main/resources/application-dev.properties
  mesos.framework.zk=your_zk1_ip:port,your_zk2_ip:port,your_zk3_ip:port,your_zk4_ip:port,your_zk5_ip:port

  NOTE: juice-service will get Mesos Master's address through Zookeeper, must add Mesos cluster to Zookeeper cluster to do the HA switch.
~~~~

* Install mysql5.6 or later

~~~~
    1.Create mysql database juice and schema as juice.
    
    2.Run /script/juice_2017-V1.0-OPEN.sql to create tables juice_framework and juice_task.

    3.Modify the configuration, juice-jooq/pom.xml：
    <configuration>
      <jdbc>
        <driver>com.mysql.jdbc.Driver</driver>
        <url>jdbc:mysql://your_ip:your_port/juice</url> <!-- ip & port & database name -->
        <user>your username</user> <!-- username of database -->
        <password>your password</password> <!-- password of database -->
      </jdbc>
      <generator>
        <database>
          <name>org.jooq.util.mysql.MySQLDatabase</name>
          <includes>juice_task|juice_framework</includes>
          <inputSchema>juice</inputSchema> <!-- schema name -->
          <outputSchema></outputSchema>
          <outputSchemaToDefault>true</outputSchemaToDefault>
        </database>
        <generate>
          <pojos>true</pojos>
          <!--<springAnnotations>true</springAnnotations>-->
          <!--<validationAnnotations>true</validationAnnotations>-->
        </generate>
        <target>
          <packageName>com.hujiang.jooq.juice</packageName>
          <directory>target/generated-sources/jooq-mysql</directory>
        </target>
      </generator>
    </configuration>

    Modify 4,5 the configuration properties file to your database settings:
    4.juice-rest/src/main/resources/config/application-dev.properties
        spring.datasource.url=jdbc:mysql://your_ip:port/juice?useUnicode=true&characterEncoding=utf-8&autoReconnect=true&useSSL=false
        spring.datasource.username=user
        spring.datasource.password=password

    5.juice-service/src/main/resources/application-dev.properties
        db.url=jdbc:mysql://your_ip:port/juice?useUnicode=true&characterEncoding=utf-8&autoReconnect=true&useSSL=false
        db.user=user
        db.password=password

~~~~

* Install Redis3.0 or later

~~~~
    Modify 1,2 the configuration properties file to your redis settings:
    1.juice-rest/src/main/resources/config/application-dev.properties
        spring.redis.host=redis_ip
        spring.redis.port=redis_port
        spring.redis.password=

    2.juice-service/src/main/resources/application-dev.properties
        redis.host=redis_ip
        redis.port=redis_port
        redis.password=

~~~~

~~~~
Run mvn clean install at root path of project and compile. juice-service and juice-rest will be generated after compile.

Start Project:

* java -Dsystem.environment=dev -jar juice-service.jar
* java -Dspring.profiles.active=dev -jar juice-rest.jar
~~~~

## How To Use

* [API Document](doc/api_document.md)
* [Juice_SDK Sample](doc/juice_sdk_example.md)
* [Parameter Description](doc/params.md)

Step of creating task:

* Develop the ability to use Docker to start the task (main business logic) and push to Docker repository.
* Call Juice API with the task description(BODY)
* Wait for the results callback or fetch results manually.

~~~~
Juice is best suited for running Docker tasks, and it is common practice to put a Jar package into a Docker image. Submit the mirror to Dockerhub and submit a container mode task to Juice where the dockerImage parameter is the Docker mirror name.

Juice will automatically find a suitable Agent to perform this task, the caller does not have to care about which host to perform on, but only need to care about whether the task can be successful.
~~~~


## Connected and join discuss###
QQ group:554271921