[maven-invoker-plugin] branch master updated: [MINVOKER-195] Fast Build - mergeUserSettings and mirrors, docs (#21)

[ol...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

olamy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-invoker-plugin.git


The following commit(s) were added to refs/heads/master by this push:
     new 94b1951  [MINVOKER-195] Fast Build - mergeUserSettings and mirrors, docs (#21)
94b1951 is described below

commit 94b1951ecd0eb6d661393079870f6f866bcfa389
Author: Slawomir Jaranowski <s....@gmail.com>
AuthorDate: Mon Mar 30 00:51:13 2020 +0200

    [MINVOKER-195] Fast Build - mergeUserSettings and mirrors, docs (#21)
---
 src/site/apt/examples/fast-use.apt.vm | 37 +++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/src/site/apt/examples/fast-use.apt.vm b/src/site/apt/examples/fast-use.apt.vm
index 7ca185b..c607662 100644
--- a/src/site/apt/examples/fast-use.apt.vm
+++ b/src/site/apt/examples/fast-use.apt.vm
@@ -104,3 +104,40 @@ Fast Build Configuration
 
   The token <<<@localRepositoryUrl@>>> will be automatically replaced by the Invoker Plugin with the URL to the local
   repository used for the Maven invocation.
+
+Fast Build Configuration - mergeUserSettings and mirrors
+
+  When you want to use Fast Build Configuration with options <<<mergeUserSettings>>>
+  you should take care for your mirror setting.
+
+  If you have in <<<~/.m2/settings.xml>>> something like:
+
++------------------
+<mirrors>
+    <mirror>
+        <id>mirrorId</id>
+        <name>Public Mirrors</name>
+        <url>url_to_my_mirror</url>
+        <mirrorOf>*,!repo1,!repo2</mirrorOf>
+    </mirror>
+</mirrors>
++------------------
+
+  Please look at <<<mirrorOf>>> tag, single <<<*>>> means match all repositories for mirroring
+  - also repository with id <<<local.central>>> will be mirrored.
+  In effective Fast Build Configuration will not work as expected.
+
+  You should change this to similar:
+
++------------------
+<mirrors>
+    <mirror>
+        <id>mirrorId</id>
+        <name>Public Mirrors</name>
+        <url>url_to_my_mirror</url>
+        <mirrorOf>external:*,!repo1,!repo2</mirrorOf>
+    </mirror>
+</mirrors>
++------------------
+
+  Where <<<external:*>>> - matches all repositories except those using localhost or file based repositories.