[maven-integration-testing] branch master updated: add a note about mirror settings for central

[hb...@apache.org]

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

hboutemy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-integration-testing.git


The following commit(s) were added to refs/heads/master by this push:
     new 7afdd5a  add a note about mirror settings for central
7afdd5a is described below

commit 7afdd5ac24db7fad828efd0f53f1b299194ac67d
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Mon Jan 17 21:19:58 2022 +0100

    add a note about mirror settings for central
---
 core-it-suite/src/site/apt/bootstrap.apt.vm |  6 +++++-
 core-it-suite/src/site/apt/index.apt.vm     | 11 +++++++++--
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/core-it-suite/src/site/apt/bootstrap.apt.vm b/core-it-suite/src/site/apt/bootstrap.apt.vm
index 50c48b9..252fb56 100644
--- a/core-it-suite/src/site/apt/bootstrap.apt.vm
+++ b/core-it-suite/src/site/apt/bootstrap.apt.vm
@@ -29,7 +29,7 @@
 Maven Core Integration Tests Bootstrap
 
   Core IT Bootstrapping downloads from Central repository every dependency (artifacts, plugins) required to let
-  Core ITs Suite run without downloading anything later (see {{{./index.html#Core_ITs_Suite_and_Dependencies}Core ITs Suite and dependencies}} rationale).
+  Core ITs Suite run without downloading anything later (see {{{./index.html#Core_ITs_Suite_and_Dependencies_.28incl._Plugins.29}Core ITs Suite and dependencies}} rationale).
   
   Content to download is defined in {{{https://github.com/apache/maven-integration-testing/tree/master/core-it-suite/src/test/resources/bootstrap}a series of bootstrap projects}}:
 
@@ -90,3 +90,7 @@ Maven Core Integration Tests Bootstrap
 * Group 13 Dependencies
 
 %{snippet|file=${project.build.directory}/test-classes/bootstrap/group-13/target/resolve.txt}
+
+* Group 14 Dependencies
+
+%{snippet|file=${project.build.directory}/test-classes/bootstrap/group-14/target/resolve.txt}
diff --git a/core-it-suite/src/site/apt/index.apt.vm b/core-it-suite/src/site/apt/index.apt.vm
index e21eb07..a0f1cc9 100644
--- a/core-it-suite/src/site/apt/index.apt.vm
+++ b/core-it-suite/src/site/apt/index.apt.vm
@@ -44,7 +44,7 @@ mvn -Preporting site
 %{snippet|file=${project.build.directory}/info.txt}
 
 
-* Core ITs Suite and Dependencies
+* Core ITs Suite and Dependencies (incl. Plugins)
 
  A good IT does not depend on external repos like Central, it uses dedicated test plugins and test repositories.
  The {{{https://github.com/apache/maven-integration-testing/blob/master/core-it-suite/src/test/resources-filtered/settings.xml}default <<<settings.xml>>>}}
@@ -63,7 +63,14 @@ mvn -Preporting site
  what is populated during bootstrapping. When forgetting, typical failures (as seen in ASF CI) will give following traces in log:
 
 -------
-[INFO] Downloading from central: file:target/null/...
+[ERROR] testit(org.apache.maven.it.MavenITmng...)  Time elapsed: 0.145 s  <<< ERROR!
 ...
 [ERROR] Failed to execute goal ... (...) on project ...: ... Could not find artifact ... in central (file:target/null) -> [Help 1]
 -------
+
+** Using Local Repository Manager
+
+ If you are using a local repository manager, configured in your <<<~/.m2/settings.xml>>> as a mirror of <<<central>>>, it will invalidate previous setup:
+ working Core ITs Suite can work on your laptop but fail on ASF CI because of missing artifact.
+
+ Comment out your mirror configuration to enable the expected local failure, then be able to debug and fix the issue.