mirror of https://github.com/apache/ant-ivy
100 lines
2.7 KiB
Plaintext
100 lines
2.7 KiB
Plaintext
////
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
https://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
////
|
|
|
|
= Mirrored resolver
|
|
|
|
[]
|
|
|=======
|
|
|Tag|mirroredurl
|
|
|Handle latest|yes with HTTP URLs (and Apache server) and with file URLs, no with other URLs
|
|
|Handle publish|no
|
|
|=======
|
|
|
|
|
|
[*__since 2.3__*]
|
|
|
|
[ivysettings.resolvers.mirroredurl]#This resolver can resolve dependencies against several mirrors of the same repository.# From a list of mirror URLs, it will iteratively try to resolve the dependencies against each one.
|
|
|
|
|
|
== Attributes
|
|
|
|
This resolver shares the link:../settings/resolvers{outfilesuffix}#common[common attributes] of standard resolvers.
|
|
|
|
[options="header",cols="15%,50%,35%"]
|
|
|=======
|
|
|Attribute|Description|Required
|
|
|m2compatible|True if this resolver should be Maven 2 compatible, false otherwise|No, defaults to false
|
|
|mirrorListUrl|The URL where to retrieve the list of mirror URLs.|Yes
|
|
|=======
|
|
|
|
|
|
== Child elements
|
|
|
|
|
|
[options="header"]
|
|
|=======
|
|
|Element|Description|Cardinality
|
|
|ivy|Defines a link:../concept{outfilesuffix}#patterns[pattern] for Ivy files, using the pattern attribute.|0..n
|
|
|artifact|Defines a link:../concept{outfilesuffix}#patterns[pattern] for artifacts, using the pattern attribute.|1..n
|
|
|=======
|
|
|
|
|
|
|
|
== Example
|
|
|
|
|
|
Having the file mavenrepolist.txt content:
|
|
|
|
[source]
|
|
----
|
|
|
|
https://repo1.maven.org/maven2/
|
|
http://repo2.maven.org/maven2/
|
|
|
|
----
|
|
|
|
And the piece of settings:
|
|
|
|
[source, xml]
|
|
----
|
|
|
|
<mirroredurl name="mirrored-maven" m2compatible="true" mirrorListUrl="file:///Users/me/dev/repo/mavenrepolist.txt">
|
|
<artifact pattern="[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"/>
|
|
</mirroredurl>
|
|
|
|
----
|
|
|
|
It will resolve first on the `repo1` and if failing it will fall back on `repo2`.
|
|
|
|
|
|
'''
|
|
|
|
|
|
The mirror list can be retrieved from a geo-location aware URL:
|
|
|
|
[source, xml]
|
|
----
|
|
|
|
<mirroredurl name="mirrored-asf" mirrorListUrl="http://www.apache.org/dyn/closer.cgi">
|
|
<ivy pattern="repo/[organisation]/[module]/[revision]/ivy.xml"/>
|
|
<artifact pattern="repo/[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"/>
|
|
</mirroredurl>
|
|
|
|
----
|