Hygieia Feature Collectors / VersionOne

Retrieves VersionOne feature content data from the source system APIs and places it in a MongoDB for later retrieval and use by the DevOps Dashboard

This project uses Spring Boot to package the collector as an executable JAR with dependencies.

Building and Deploying

To package the collector into an executable JAR file, run:

mvn install

Copy this file to your server and launch it using :

java -jar versionone-feature-collector.jar

application.properties

You will need to provide an application.properties file that contains information about how to connect to the Dashboard MongoDB database instance, as well as properties the VersionOne feature collector requires. See the Spring Boot documentation for information about sourcing this properties file.

Sample application.properties file

# Database Name
dbname=dashboard

# Database HostName - default is localhost
dbhost=localhost

# Database Port - default is 27017
dbport=27017

# MongoDB replicaset
dbreplicaset=[false if you are not using MongoDB replicaset]
dbhostport=[host1:port1,host2:port2,host3:port3]

# Database Username - default is blank
dbusername=db

# Database Password - default is blank
dbpassword=dbpass

# Logging File location
logging.file=./logs/versionone.log

# PageSize - Expand contract this value depending on VersionOne implementation's
# default server timeout setting (You will likely receive a SocketTimeoutException)
feature.pageSize=2000

# Delta change date that modulates the collector item task
# Occasionally, these values should be modified if database size is a concern
feature.deltaStartDate=2016-03-01T00:00:00.000000
feature.masterStartDate=2016-03-01T00:00:00.000000
feature.deltaCollectorItemStartDate=2016-03-01T00:00:00.000000

#############################################################################
# Maximum Kanban iteration length allowed for a sprint start/end date before
# being converted a Kanban generic type iteration.  e.g., If you want anything
# longer than a 3 week sprint to be considered as Kanban in the Feature Widget,
# change this value to say: 36.  Default value is 28 days.
#
# Note:  This field otherwise does NOT need to be included, and is commented out
#############################################################################
#
# feature.maxKanbanIterationLength=28

# Chron schedule: S M D M Y [Day of the Week]
feature.cron=0 * * * * *

# VERSIONONE CONNECTION DETAILS:
# Enterprise Proxy - ONLY INCLUDE IF YOU HAVE A PROXY
feature.versionOneProxyUrl=http://proxy.com:9000
feature.versionOneBaseUri=https://versionone.com
feature.versionOneAccessToken=dGhpc2lzYXRva2VuZnJvbXYx

# ST Query File Details - Required, but DO NOT MODIFY
feature.queryFolder=v1api-queries
feature.storyQuery=story
feature.projectQuery=projectinfo
feature.teamQuery=teaminfo
feature.trendingQuery=trendinginfo

Implementation Details:

[TBA]