README.asciidoc

   1 = Maven Build Process image:https://img.shields.io/badge/email-%40metio-brightgreen.svg?style=social&label=mail["Discuss on Google Groups", link="https://groups.google.com/forum/#!forum/metio"] image:https://img.shields.io/badge/irc-%23metio.wtf-brightgreen.svg?style=social&label=IRC["Chat on IRC", link="http://webchat.freenode.net/?channels=metio.wtf"]
   2 Sebastian Hoß <http://seb.xn--ho-hia.de/[@sebhoss]>
   3 :github-org: sebhoss
   4 :project-name: maven-build-process
   5 :project-group: de.xn--ho-hia.maven
   6
   7 ++++
   8 <div class="paragraph">
   9 <p><span class="image"><a class="image" href="http://creativecommons.org/publicdomain/zero/1.0/"><img src="https://img.shields.io/badge/license-cc%20zero-000000.svg?style=flat-square" alt="CC Zero"></a></span>
  10 <span class="image"><a class="image" href="https://maven-badges.herokuapp.com/maven-central/de.xn--ho-hia.maven/maven-build-process"><img src="https://img.shields.io/maven-central/v/de.xn--ho-hia.maven/maven-build-process.svg?style=flat-square" alt="Maven Central"></a></span>
  11 <span class="image"><a class="image" href="https://hub.docker.com/r/sebhoss/maven-build-environment/"><img src="https://img.shields.io/docker/automated/sebhoss/maven-build-environment.svg?style=flat-square" alt="Docker Hub"></a></span>
  12 <span class="image"><a class="image" href="https://www.openhub.net/p/maven-build-process"><img src="https://www.openhub.net/p/maven-build-process/widgets/project_thin_badge.gif" alt="Open Hub statistics"></a></span>
  13 <span class="image"><a class="image" href="https://travis-ci.org/sebhoss/maven-build-process"><img src="https://img.shields.io/travis/sebhoss/maven-build-process/master.svg?style=flat-square" alt="Build Status"></a></span>
  14 </div>
  15 ++++
  16
  17 Bunch of POMs that help setting up a link:http://maven.apache.org/[Maven] based build process.
  18
  19 == Usage
  20
  21 === Maven Parent
  22
  23 Inherit from one of the parents like this:
  24
  25 [source, xml]
  26 ----
  27   <!-- for early prototypes -->
  28   <parent>
  29     <groupId>de.xn--ho-hia.maven.parents</groupId>
  30     <artifactId>maven-parents-java-prototype</artifactId>
  31     <version>${version.parent}</version>
  32   </parent>
  33
  34   <!-- for stable projects -->
  35   <parent>
  36     <groupId>de.xn--ho-hia.maven.parents</groupId>
  37     <artifactId>maven-parents-java-stable</artifactId>
  38     <version>${version.parent}</version>
  39   </parent>
  40 ----
  41
  42 Specify SCM, Issue Management, CI Management, and Distribution Management sections of your POM in case you want to deploy into link:http://search.maven.org/[Maven Central].
  43
  44 === Docker Build Environment
  45
  46 The build environment can be used together with docker-compose like this:
  47
  48 [source, yaml]
  49 ----
  50 version: '2'
  51 services:
  52   verify-project:
  53     image: sebhoss/maven-build-environment:latest
  54     container_name: my-verifier
  55     volumes:
  56       - "./:/project"
  57     working_dir: /workspace
  58     command: bash -c "cp -af /project/. . && mvn clean verify -s /config/local-nexus-mirror.xml -Dmaven.repo.local=/repository"
  59     networks:
  60       - nexus
  61 networks:
  62   nexus:
  63     external:
  64       name: nexus_default
  65 ----
  66
  67 Execute this by calling `docker-compose run --rm verify-project`. Executing builds directly inside the `/project` directory will most likely cause a permission problem on the host system. Therefore the above `docker-compose.yml` file copies the project source into the `/workspace` directory first. The `--rm` option makes sure that everything gets cleaned up nicely once execution is finished. Specify a *container_name* in case you want to easily reference the running container. The container includes two predefined Maven settings files:
  68
  69 * /config/google-mirror.xml (https://maven-central.storage.googleapis.com)
  70 * /config/local-nexus-mirror.xml (http://local-nexus:8081/content/groups/public/)
  71
  72 Use them together with docker networks like in the above example to run your builds against different Maven repositories. The local `/repository` directory already includes _some_ artifacts. Re-use it in order to cut down on build time.
  73
  74 == License
  75
  76 To the extent possible under law, the author(s) have dedicated all copyright
  77 and related and neighboring rights to this software to the public domain
  78 worldwide. This software is distributed without any warranty.
  79
  80 You should have received a copy of the CC0 Public Domain Dedication along
  81 with this software. If not, see http://creativecommons.org/publicdomain/zero/1.0/.
  82
  83 == Mirrors
  84
  85 * https://github.com/sebhoss/{project-name}
  86 * https://bitbucket.org/sebhoss/{project-name}
  87 * https://gitlab.com/sebastian.hoss/{project-name}
  88 * http://v2.pikacode.com/sebhoss/{project-name}
  89 * http://repo.or.cz/{project-name}.git