reactive-cli

This project is a component of Lightbend Orchestration for Kubernetes. Refer to its documentation for usage, examples, and reference information.

reactive-cli is a CLI tool, rp, that can inspect Docker images created by sbt-reactive-app and generate resources for Kubernetes and potentially other target platforms.

Installation / Usage

Consult the Lightbend Orchestration for Kubernetes documentation for setup and configuration.

Developer

Build setup

The CLI depends on Scala Native to build, the setup scripts provided in the project follow the instructions on the Scala Native setup page.

Please ensure you have read through each of the platform-specific setup as there may be manual steps for you to follow.

The setup script will install the prerequisites listed below.

Prerequisites

• LVM 3.7+
• gcc
• libcurl with curl.h header file and OpenSSL support
• libgc
• libunwind
• libre2
• nexe (for JS/Windows builds)

npm specific setup

You'll need nexe on your path. One good way of setting up npm to do this is documented on this StackOverflow post.

Once setup, you can use the following command to install nexe:

npm i nexe -g

macOS specific setup

Ensure XCode is updated to Apple's latest version. With Apple's latest XCode version, the minimum LLVM version is satisfied, so Homebrew install is not required.

Once XCode is updated to Apple's latest version, execute the following command to setup the project:

$ brew install bdw-gc re2 jq && \
    brew install curl --with-openssl

Ubuntu 16 specific setup

Execute the following command to setup the project:

$ sudo apt-get install -y -qq \
    clang++-3.9 \
    libgc-dev \
    libunwind8-dev \
    libre2-dev \
    jq

Building and running

Use the following SBT command to create the native executable:

$ sbt cli/nativeLink

Once built, the native executable can be found in the cli/target/scala-2.11/rp path, i.e.

$ cli/target/scala-2.11/reactive-cli-out --help
reactive-cli 0.1.0
Usage: reactive-cli [options]

  --help             Print this help text

Packaging

This project uses a Docker-based build system that builds .rpm and .deb files inside Docker containers for each supported distribution. To add a distribution, add a BuildInfo instance in project/BuildInfo.scala emulating the ones already created.

Prerequisites

The build system uses publicly available Docker images that are pushed to Bintray. To rebuild / update these images, you'll need to run the following:

sbt buildAllDockerImages

Afterwards, it will give you the commands you must run to push these images (SBT having tagged them). For example, below is pushing one of these images:

docker push lightbend-docker-registry.bintray.io/rp/reactive-cli-build-debian-9

Note that this doesn't normally need to be done as part of project setup, as the build system will simply pull down the build images for you.

Building a single distribution package locally

sbt "build ubuntu-16-04"

Building every distribution

sbt buildAll

Once built, you can find the packages in target/stage/<name>/output.

Releasing

Consult the Lightbend Orchestration for Kubernetes document in Google Drive.

Maintenance

Enterprise Suite Platform Team es-platform@lightbend.com