rkt launcher remote

A core lib that can be used to fork `rkt` process in a type-safe way; a service exposing RESTful APIs through which the user can interact with `rkt` remotely; and last but not least, a client is shipped to ease the process talking to the service.

License	License The Apache Software License, Version 2.0
GroupId	GroupId io.honnix
ArtifactId	ArtifactId rkt-launcher-remote
Last Version	Last Version 0.0.8
Release Date	Release Date Aug 9, 2017
Type	Type jar
Description	Description rkt launcher remote A core lib that can be used to fork `rkt` process in a type-safe way; a service exposing RESTful APIs through which the user can interact with `rkt` remotely; and last but not least, a client is shipped to ease the process talking to the service.

Download rkt-launcher-remote

Filename	Size
rkt-launcher-remote-0.0.8.pom
rkt-launcher-remote-0.0.8.jar	20 KB
rkt-launcher-remote-0.0.8-sources.jar	14 KB
rkt-launcher-remote-0.0.8-javadoc.jar	92 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.honnix/rkt-launcher-remote/ -->
<dependency>
    <groupId>io.honnix</groupId>
    <artifactId>rkt-launcher-remote</artifactId>
    <version>0.0.8</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.honnix/rkt-launcher-remote/
implementation 'io.honnix:rkt-launcher-remote:0.0.8'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.honnix/rkt-launcher-remote/
implementation ("io.honnix:rkt-launcher-remote:0.0.8")

Apache Buildr

'io.honnix:rkt-launcher-remote:jar:0.0.8'

Apache Ivy

<dependency org="io.honnix" name="rkt-launcher-remote" rev="0.0.8">
  <artifact name="rkt-launcher-remote" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.honnix', module='rkt-launcher-remote', version='0.0.8')
)

Scala SBT

libraryDependencies += "io.honnix" % "rkt-launcher-remote" % "0.0.8"

Leiningen

[io.honnix/rkt-launcher-remote "0.0.8"]

Dependencies

compile (4)

Group / Artifact	Type	Version
io.honnix : rkt-launcher-common	jar	0.0.8
com.spotify : apollo-api	jar
com.spotify : completable-futures	jar	0.2.0
com.squareup.okhttp : okhttp	jar

test (5)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.mockito : mockito-core	jar	2.8.47
org.slf4j : slf4j-simple	jar	1.7.25
org.powermock : powermock-module-junit4	jar	1.7.0
org.powermock : powermock-api-mockito2	jar	1.7.0

Project Modules

There are no modules declared in this project.

rkt-launcher

To launch rkt in a type-safe way using Java (a.k.a rkt Java API).

rkt is designed to be used as a command line executable without having a daemon. To understand the design philosophy, you are encouraged to read this document.

rkt-launcher starts with a core lib that can be used to fork rkt process in a type-safe way; then it provides a service exposing RESTful APIs through which the user can interact with rkt remotely; and last but not least, a client is shipped to ease the process talking to the service.

This project is in beta stage. Most of the features have been implemented and can be used for production. Backward compatibility will be ensured on a best efforts basis.

Usage

Prerequisite

rkt has been installed, check here for details
JDK8 has been installed
Maven has been installed

To build

$ git clone [email protected]:honnix/rkt-launcher.git
$ mvn package

To start the service:

$ java -jar rkt-launcher-service/target/rkt-launcher-service.jar -Dhttp.server.port=8080

To start hacking

Import the maven project to your favorite IDE or choose whatever editor you like. Well, it's just plain Java.

rkt-launcher-common

This module contains options passed to rkt, models capturing rkt output and a few utilities handling JSON, time, etc.

rkt-launcher-core

Core library to fork rkt process and handle output.

rkt-launcher-service

This module exposes RESTful APIs to fork rkt process and handle output.

This service is built using Apollo framework.