jameshnsears / junit-docker-http

JUnit 5 Parameter Resolver & API that minimally leverages the Docker Engine API. See Maven Central.

junit-docker-http

• JUnit 5 Parameter Resolver & API that minimally leverages the Docker Engine API.

1. Introduction

• A "keep it simple" JUnit 5 Parameter Resolver & API that lets you easily:

  • pull docker images - if not already pulled.
  • start containers - with various, optional, parameters - i.e. ports; networks; volumes; commands.
  • stop containers.

• Uses a simple config.json file to define container setup; then flesh out your test with simple API calls that sit on top of the Docker Enginer API.

1.1. Example Usage - using local path as a volume mount

• see: DockerConfigurationXqaTest.java and config-xqa.json

2. Publishing to Maven Central

2.1. settings.xml

• decrypt settings.xml.pgp
• cp settings.xml ~/.m2

2.2. Deploy

export JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

2.2.1. To staging repo

• mvn -DperformRelease=true clean deploy
  • enter private pgp key password
• visit:
  • https://oss.sonatype.org/#nexus-search;quick~junit-docker-http

2.2.2 To release repo

• (optionally) https://www.youtube.com/watch?v=dXR4pJ_zS-0&feature=youtu.be
• remove "-SNAPSHOT" in pom.xml + increment version #.
• mvn -DperformRelease=true clean deploy
  • enter private pgp key password