Metadata Registry

This repository contains submodules so you will need to execute:

	git clone --recursive https://github.com/zmhassan/metadatapoc

or

	git clone https://github.com/zmhassan/metadatapoc
	git sub module init

Environment Variables:

META_LOG_LOCATION

• This is required by the metadata-consumer app as it will be looking in this location for data
• Usage example:

	META_LOG_LOCATION=logs/analytics.log

META_SCHEMA_LOCATION

• This is required by the metadata-producer app as it will be looking in this location for data
• Usage example:

	META_SCHEMA_LOCATION=/tmp/schema.json

META_KAFKA_BROKERLIST

• This is required by the metadata-producer app as it will be looking in this location for data
• Usage example:

	META_KAFKA_BROKERLIST="localhost:9092"

DOCKER_HOST

• Used for running producer and consumer in docker containers
• This is required for development only
• Usage example:

	DOCKER_HOST=tcp://<host>:2375

Building from source

	mvn clean install -Prelease
	cd assembly/target
	tar -zxvf <NAME>.tar.gz # or unzip ./assembly/target/metadata-distro-assembly-1.0.0-SNAPSHOT-bin.zip

Usage example:

Metadata consumer or producer

    cd assembly/target/
    java -jar metadata-consumer-1.0.0-SNAPSHOT.jar
    java -jar metadata-producer-1.0.0-SNAPSHOT.jar

Metadata Maven Plugin Usage:

• Add the following to your maven pom to use this plugin as it will create for you the class and will require the schema.json to recreate your pojo.
• Note: schemaurl should be set to file:////<NAME_OF_SCHEMA_FILE>.json. If you use classpath:... then it will look inside of the /src/main/resources/.

		<properties>
		   <schemaurl>classpath:/schema.json</schemaurl>
		   <classname>GeneratedCustomer</classname>
		   <packagename>org.jboss.perspicuus.generated</packagename>
		</properties>

		....

		<build>
		<plugins>
			...
			<plugin>
			   <groupId>org.jboss.perspicuus</groupId>
			   <artifactId>metadata-maven-plugin</artifactId>
			   <version>1.0.0-SNAPSHOT</version>
			   <executions>
			      <execution>
			         <phase>process-resources</phase>
			         <goals>
			            <goal>codegen</goal>
			         </goals>
			         <configuration>
			            <schemaurl>${schemaurl}</schemaurl>
			            <classname>${classname}</classname>
			            <packagename>${packagename}</packagename>
			         </configuration>
			      </execution>
			   </executions>
			</plugin>
			...
		</plugins>
		</build>

Docker

Included in the root of the project you will find a docker-compose file which will spin up a kafka message broker with zookeeper running in docker containers for those interested in running this without installing many new technologies.

docker-compose up -d
docker-compose ps

PAAS: Kubernetes/Openshift v3