SeaClouds Platform

==================    

This is a proof of concept of the SeaClouds Platform (www.seaclouds-project.eu), integrating a first version of the Discoverer & Planner (considering the Matchmaker process), Deployer, Monitor and SLA Service components, into a Unified Dashboard.

This work is part of the ongoing European research project EC-FP7-ICT-610531 SeaClouds, and it's currently under development.

Building SeaClouds

Building SeaClouds shouldn't be a big deal, however it has the following prerequisites:

• Git
• Java 7 JDK.
• Maven 3.3.3 or greater.
• Node.js 0.12.x (with npm) or greater.

After you have been installed all the prerequisites, you can download the master branch of the repository from git with git clone git@github.com:SeaCloudsEU/SeaCloudsPlatform.git and build it with mvn clean install (if you want to skip the tests, please add -DskipTest flag).

Deploy SeaClouds

A deployment of SeaClouds can be launched using Apache Brooklyn. We currently support deployments against Bring Your Own Nodes (BYON) and to all the IaaS provider supported by Apache jclouds.

Setup your environment

Make sure you have Vagrant, Virtualbox

Unless you are running on Ubuntu 12.04.1 64bit server, you may want to setup you local environment first.

• Configure your local environment:

  cd $SEACLOUDS_HOME/byon
  vagrant up brooklyn

  This spins up an Apache Brooklyn server accessible at http://10.10.10.100:8081.

Deploying SeaClouds on BYON

• Point your favourite browser at http://10.10.10.100:8081
• Select SeaClouds Platform on BYON application from Apache Brooklyn dropdown menu
• Click on YAML Composer button.
• Finally click Deploy button.

Notice: all the SeaClouds services will report a URL similar to http://127.0.0.1:3000 To reach it from your browser, you have to reach http:10.10.10.100:3000 instead.

Deploying SeaClouds on the cloud

• Point your favourite browser at http://10.10.10.100:8081
• Select SeaClouds platform application from Apache Brooklyn dropdown menu
• Click on YAML Composer button.
• Edit locationsection specifying the cloud provider and the credentials to use it, in the YAML format.
• Click on Deploy button

SeaClouds release 1.0.0

A detailed description of SeaClouds 1.0.0 release including:

• SeaClouds components and their interactions
• A guide to get an install SeaClouds Platform
• An example of how to use SeaClouds Platform and exploit its capabilities and the capabilies of each of its components

can be found in the Integrated Platform deliverable.

Contributing

If you want to help us with the development of this project please read carefully our Contributing Guide.

Troubleshooting

When deploying SeaClouds platform an Apache Brooklyn instance will be started on your workstation, accessible at http://localhost:8081 by default. Please double-check in nohup.out the correct url.

For more information, please visit Apache Brooklyn

How to release it!

In order to release a new version:

• mvn clean install If everything is ok:
• mvn -DdryRun=true release:prepare -DreleaseVersion=1.0.0 -Dtag=1.0.0 -DdevelopmentVersion=1.1.0-SNAPSHOT and wait for a message like Release preparation simulation complete.

Then:

• mvn release:clean

• mvn release:prepare -DreleaseVersion=1.0.0 -Dtag=1.0.0 -DdevelopmentVersion=1.1.0-SNAPSHOT

• mvn release:perform

• test the staging repository, and finally promote release it!

License

Licensed under the Apache License, Version 2.0.