es-maven-parent

This Maven plugin provides goals that starts/stops the event store [PARENT].

License	LGPL
Categories	Maven Build Tools
GroupId	org.fuin.esmp
ArtifactId	es-maven-parent
Last Version	0.5.1
Release Date	Mar 8, 2020
Type	pom
Description	es-maven-parent This Maven plugin provides goals that starts/stops the event store [PARENT].
Project Organization	fuin.org (Germany)
Source Code Management	https://github.com/fuinorg/event-store-maven-plugin/

Download es-maven-parent

Filename	Size
es-maven-parent-0.5.1.pom	1 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.fuin.esmp/es-maven-parent/ -->
<dependency>
    <groupId>org.fuin.esmp</groupId>
    <artifactId>es-maven-parent</artifactId>
    <version>0.5.1</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.fuin.esmp/es-maven-parent/
implementation 'org.fuin.esmp:es-maven-parent:0.5.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.fuin.esmp/es-maven-parent/
implementation ("org.fuin.esmp:es-maven-parent:0.5.1")

Apache Buildr

'org.fuin.esmp:es-maven-parent:pom:0.5.1'

Apache Ivy

<dependency org="org.fuin.esmp" name="es-maven-parent" rev="0.5.1">
  <artifact name="es-maven-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.fuin.esmp', module='es-maven-parent', version='0.5.1')
)

Scala SBT

libraryDependencies += "org.fuin.esmp" % "es-maven-parent" % "0.5.1"

Leiningen

[org.fuin.esmp/es-maven-parent "0.5.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• es-maven-plugin
• es-maven-test

event-store-maven-plugin

This Maven plugin provides goals that start/stop the event store.

Getting started

Just add the plugin to your Maven POM:

<plugin>	
	<groupId>org.fuin.esmp</groupId>
	<artifactId>es-maven-plugin</artifactId>
	<version>0.5.1</version>
	<executions>
		<execution>
			<goals>
				<goal>download</goal>
				<goal>certificate</goal>
				<goal>start</goal>
				<goal>stop</goal>
			</goals>
		</execution>
	</executions>
    <!-- The default is '--mem-db=TRUE' if you don't include the configuration -->
    <configuration>
    	<!-- Selects the correct OS sub type by name for example 'Ubuntu 18' vs 'Ubuntu 16' -->
        <download-os-qualifier>Ubuntu 18</download-os-qualifier>
    	<!-- Creates a self-signed X509 certificate -->
    	<certificate-file>${project.build.directory}/domain.p12</certificate-file>
    	<!-- Start the event store in-memory with some parameters -->
        <arguments>			         
            <argument>--mem-db=FALSE</argument>
            <argument>--stats-period-sec=3000</argument>
            <argument>--ext-tcp-port=7773</argument>
            <argument>--ext-secure-tcp-port=7779</argument>
            <argument>--certificate-file=${project.build.directory}/domain.p12</argument>
            <argument>--run-projections=All</argument>
            <argument>--log=/tmp/log-eventstore</argument>
        </arguments>
    </configuration>
</plugin>

This will download the latest event store version to the 'target' build directory, create a self-signed certificate and start it before the integration tests will run. After execution the event store will be stopped.

A full example how to use it can be found here: test-project

Remember to name your test class according to Maven Failsafe Plugin's naming pattern.

To execute your integration test use: mvn clean verify or mvn verify

Using a certain event store version

If you want to use a fix event store version version you can use the download-url configuration property to set it in the plugin.

<plugin>	
	<groupId>org.fuin.esmp</groupId>
	<artifactId>es-maven-plugin</artifactId>
	<version>0.5.1</version>
	<executions>
		<execution>
			<goals>
				<goal>download</goal>
				<goal>start</goal>
				<goal>stop</goal>
			</goals>
		</execution>
	</executions>
    <configuration>
        <download-url>https://eventstore.org/downloads/ubuntu/EventStore-OSS-Linux-Ubuntu-18.04-v5.0.6.tar.gz</download-url>
    </configuration>
</plugin>

Changing the location of the event store version JSON file

In the past the Event Store team moved the JSON file that contains download information for event store versions to another location. In case this happens again you can quickly use the version-url configuration property to change it in the plugin.

<plugin>	
	<groupId>org.fuin.esmp</groupId>
	<artifactId>es-maven-plugin</artifactId>
	<version>0.5.1</version>
	<executions>
		<execution>
			<goals>
				<goal>download</goal>
				<goal>start</goal>
				<goal>stop</goal>
			</goals>
		</execution>
	</executions>
    <configuration>
        <version-url>https://raw.githubusercontent.com/EventStore/eventstore.org/master/_data/downloads.json</version-url>
    </configuration>
</plugin>

Snapshots

Snapshots can be found on the OSS Sonatype Snapshots Repository.

Add the following to your .m2/settings.xml to enable snapshots in your Maven build:

<pluginRepository>
    <id>sonatype.oss.snapshots</id>
    <name>Sonatype OSS Snapshot Repository</name>
    <url>http://oss.sonatype.org/content/repositories/snapshots</url>
    <releases>
        <enabled>false</enabled>
    </releases>
    <snapshots>
        <enabled>true</enabled>
    </snapshots>
</pluginRepository>

fuin.org

Versions

Version
0.5.1 Mar 8, 2020
0.5.0 Jan 2, 2019
0.4.3 May 11, 2018
0.4.2 Oct 2, 2017
0.4.1 Oct 11, 2016
0.4.0 Aug 21, 2016
0.3.1 Jul 2, 2015
0.3.0 Jun 19, 2015
0.2.0 May 11, 2015
0.1.0 May 10, 2015