Apache
/
maven
mirror of https://github.com/apache/maven.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

add a note about mirror settings for central

This commit is contained in:
Hervé Boutemy 2022-01-17 21:19:58 +01:00
parent d3cbcdaa9b
commit 5b67a4e846
2 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
its/core-it-suite/src/site/apt/bootstrap.apt.vm
View File

@ -29,7 +29,7 @@
Maven Core Integration Tests Bootstrap Maven Core Integration Tests Bootstrap
Core IT Bootstrapping downloads from Central repository every dependency (artifacts, plugins) required to let 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}}: 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 * Group 13 Dependencies
%{snippet|file=${project.build.directory}/test-classes/bootstrap/group-13/target/resolve.txt} %{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}

11
its/core-it-suite/src/site/apt/index.apt.vm
View File

@ -44,7 +44,7 @@ mvn -Preporting site
%{snippet|file=${project.build.directory}/info.txt} %{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. 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>>>}} 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: 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] [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.