Public | Automated Build

Last pushed: 6 months ago
Short Description
Uluwatu is a web UI for Cloudbreak - a cloud agnostic Hadoop as a Service API.
Full Description

Uluwatu is situated at the southern end of Bali and is the island most famous and consistent wave. The spot offers several waves which are working with different swells and tides.

Uluwatu is a web UI for Cloudbreak - a cloud agnostic Hadoop as a Service API.

##Cloudbreak UI

When we have started to work on Cloudbreak, our main goal was to create an easy to use, cloud and Hadoop distribution agnostic Hadoop as a Service API. Though we always like to automate everything and approach things with a very DevOps mindset, as a side project we have created a UI for Cloudbreak as well.
The goal of the UI is to ease to process and allow you to create a Hadoop cluster on your favourite cloud provider in one-click.

The UI is built on the foundation of the Cloudbreak REST API. You can access our hosted version here.

###Manage credentials

Using manage credentials you can link your cloud account with the Cloudbreak account and define the keys for accessing to the created resources.

###Manage blueprints

Blueprints are your declarative definition of a Hadoop cluster.

###Manage resources

Using manage resources you can create custom templates for provider specific instances.

###Manage networks

Via network management you can easily configure the subnet, network id(in case of openstack) of the newly provisioned virtual network or use an existing virtual network.

###Manage security groups

Security groups are able to manage a set of security rule that could open ports on the specified protocol and subnet.

###Create cluster
Using the create cluster functionality you will create a cloud Stack and a Hadoop Cluster. In order to create a cluster you will have to select a credential first.
Note: Cloudbreak can maintain multiple cloud credentials (even for the same provider).

Once you have launched the cluster creation you can track the progress either on Cloudbreak UI or your cloud provider management UI.

Note: Because Azure does not directly support third party public images we will have to copy the used image from VM Depot into your storage account. This process will take 20 minutes so be patient - but this step will have to be done only once.

##Technical details

Uluwatu is a small node.js webapp with an Angular.js frontend. The main logic is on the client side, the node backend has only the following reposibilities:

  • provides an HTTP server that serves the static HTML/JS/CSS content
  • proxies every request coming from the Angular side to Cloudbreak therefore eliminating the need for CORS
  • obtains an OAuth2 token from an identity server to Cloudbreak by handling the authorization code flow

####Browser compatibility

  • Internet Explorer 10 or newer
  • Chrome 32 or newer
  • Safari 6 or newer
  • Firefox 24 or newer

###Running Uluwatu locally for development

If you'd like to run Uluwatu on your local machine, you should have npm and node.js installed. After checking out the git repository, run npm install && cd app/static && bower install in Uluwatu's directory.

The easiest way to run development environment of Uluwatu is to use cloudbreak-deployer.
To configure local Uluwatu source location use ULUWATU_VOLUME_HOST variable in your Profile file.

export ULUWATU_VOLUME_HOST=/path/of/uluwatu/source

Please note that you need to (re)generate your config files after variable changed. After (re)generation you have to simply execute cbd start command.

When you create a pull request please format your code with the script.

###Running Uluwatu in Docker

If you'd like to deploy a stable version of Uluwatu somewhere, we recommend to use its Docker image (that's how we do it in production) so it's not needed to have node installed on the server. This image grabs the latest release from the Github repo and starts the node server. The environment variables should be provided like above.

docker run -d --name uluwatu \
 -p 3000:3000 sequenceiq/uluwatu


Docker Pull Command
Source Repository