ignacio-dc/mesos-rxjava

RxJava client for Apache Mesos HTTP APIs

Mesos RxJava

Mesos RxJava is a library that provides a Reactive Client (via RxJava) atop Apache Mesos' new HTTP APIs.

Background

Apache Mesos is a Cluster Resource manager providing access to cluster resources such as CPU, RAM, Disk and Ports. In order to leverage these computing resources a program called a framework is created and registers with Mesos. Once registered a framework can launch tasks using the resources offered by Mesos.

In an effort to allow Mesos to be more accessible to more languages, HTTP APIs are being developed to allow polyglot access to authoring frameworks. Prior to the HTTP APIs, libmesos (C++ library) had to be used.

Project Goal

This project's primary goal is to provide a Java client for interacting with these new HTTP APIs. Mesos' HTTP APIs are modeled as an event stream; as such a scheduler can be modeled as an rx.Observable<Event>. Once created, the scheduler is able to use the powerful stream manipulation functions provided by RxJava to react to events.

Javadocs

Javadocs for the last successful build of master can be found here

Maven Coordinates

Stable Release

Releases are available in Maven Central.

Protobuf Client

<dependency>
    <groupId>com.mesosphere.mesos.rx.java</groupId>
    <artifactId>mesos-rxjava-protobuf-client</artifactId>
    <version>0.2.0</version>
</dependency>

Testing Tools

<dependency>
    <groupId>com.mesosphere.mesos.rx.java</groupId>
    <artifactId>mesos-rxjava-test</artifactId>
    <version>0.2.0</version>
    <scope>test</scope>
</dependency>

Snapshot Release

Snapshot Repo

Version 0.1.0-SNAPSHOT has been published to the Sonatype OSS Snapshot Repo.

<repositories>
    <repository>
        <id>ossrh</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Protobuf Client

<dependency>
    <groupId>com.mesosphere.mesos.rx.java</groupId>
    <artifactId>mesos-rxjava-protobuf-client</artifactId>
    <version>0.2.1-SNAPSHOT</version>
</dependency>

Testing Tools

<dependency>
    <groupId>com.mesosphere.mesos.rx.java</groupId>
    <artifactId>mesos-rxjava-test</artifactId>
    <version>0.2.1-SNAPSHOT</version>
    <scope>test</scope>
</dependency>

Build

Mesos RxJava is defined by a Maven project and targeted at Java 1.8.

Install Maven

Install Maven 3.2.x or newer

Running Tests

mvn clean test

Packaging Artifacts

mvn clean package

Resources

1. Apache Mesos
2. Mesos HTTP Scheduler API v1
3. RxJava
4. ReactiveX