Monasca common classes

Go to file

Ryan Brandt 41457907ab Allow spaces and apostrophes in dimensions Change-Id: I0f6a00496e65eeadb946849e68107321310a1a11		2015-08-06 13:59:46 -06:00
java	Allow spaces and apostrophes in dimensions	2015-08-06 13:59:46 -06:00
.gitignore	added test for parsing strings	2014-07-09 15:35:52 -07:00
.gitreview	Get initial build to work	2014-07-20 08:23:35 -06:00
LICENSE	Added license file	2014-05-01 16:22:06 -07:00
README.md	Change package names from com.hpcloud to monasca.common	2014-10-14 10:02:34 -06:00
mkdocs.yml	Added a config file for documentation	2015-02-24 01:02:47 +00:00
pom.xml	Bump to version 1.1	2015-04-27 13:32:34 -06:00
run_maven.sh	Fail main maven build if java maven build fails	2015-02-19 12:53:22 -07:00

README.md

Overview

monasca-common is a collection of sub-projects containing reusable application and platform code for building monitoring related services.

Build Instructions

Download and do mvn install.

cd java
mvn clean install

There is a pom.xml in the base directory but that should only be used for the StackForge build. The issue is that currently StackForge's bare-precise system only has Maven 2 on it and at least one of the modules of monasca-common requires Maven 3.

In order to get around this problem, the pom.xml in the base directory uses the exec-maven-plugin to run the script run_maven.sh. This script checks if the version of mvn is Maven 3 and if it is not, it downloads Maven 3 and then uses it to run the build in the java directory.

In addition, the run_maven.sh script copies the jar files that get built from java/*/target directories to the target directory in the base project directory. This is because the StackForge "monasca-common-localrepo-upload" job uploads any jar files from that directory to http://tarballs.openstack.org/ci/monasca-common. Copying the jar files to that directory made it so there didn't have to be changes made to the "monasca-common-localrepo-upload" job. The build for monasca-thresh downloads the jars it depends on from that location on tarballs.openstack.org.

A change has been submitted to StackForge to switch to bare-trusty for this build in the hopes that those systems will have maven 3, but it is not known how long that change will take to be accepted.

Application Specific Sub-Projects

monasca-common-model - Common domain and event models for monitoring services.

Platform Sub-Projects

monasca-common-dropwizard - Utilities for building and testing dropwizard services.
monasca-common-kafka - Various utilities for working with Kafka.
monasca-common-persistence - Persistence related infrastructure and utilities.
monasca-common-service - Simple service abstractions and utilities.
monasca-common-streaming - Streaming related utilities.
monasca-common-testing - A set of testing related dependencies.
monasca-common-util - Various utilities such as for serialization, dependency injection, date and time, invocation retries, concurrency, etc.