monasca-common/README.rst
Ghanshyam Mann b70afb9bf6 [ussuri][goal] Drop python 2.7 support and testing
OpenStack is dropping the py2.7 support in ussuri cycle.

monasca-common is ready with python 3 and ok to drop the
python 2.7 support.

Complete discussion & schedule can be found in
- http://lists.openstack.org/pipermail/openstack-discuss/2019-October/010142.html
- https://etherpad.openstack.org/p/drop-python2-support

Ussuri Communtiy-wide goal:
https://governance.openstack.org/tc/goals/selected/ussuri/drop-py27.html

Change-Id: Ibf95dffdebe47c8ea4a8a8a666ac6f66d9b4c774
2019-11-16 16:54:42 +00:00

4.2 KiB
Raw Blame History

Team and repository tags

image

Overview

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

Python

To install the Python monasca-common modules, git clone the source and run the following command:

$ sudo python setup.py install

To run the unit tests use:

$ tox -e py35

For information on contributing, see Contribution Guidelines.

Java

Build Instructions

Download and do mvn install.

$ cd java
$ mvn clean install

Caution

There is a pom.xml in the base directory but that should only be used for the Zuul build.

The issue is that currently StackForges 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 didnt 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

Platform Sub-Projects