Skip to content
Browse files

More about mvn vs. ivy proxies

  • Loading branch information...
1 parent 44650ca commit 88ca4aec64e650643a14b292c077c2eab2c6a308 @jsuereth jsuereth committed with Oct 12, 2012
View
20 src/sphinx/Detailed-Topics/Proxy-Repositories.rst
@@ -29,7 +29,8 @@ the big three being (in alphabetical order):
* Nexus_
Once you have a proxy repository installed and configured,
-then it's time to configure SBT for your needs.
+then it's time to configure SBT for your needs. Read the
+note at the bottom about proxy issues with ivy repositories.
sbt Configuration
@@ -109,6 +110,23 @@ repository file.
+Proxying Ivy Repositories
+=========================
+The most common mistake made when setting up a proxy repository for
+sbt is the attempting to *merge* both *maven* and *ivy* repositories
+into the *same* proxy repository. While some repository managers will
+allow this, it's not recommended to do so.
+
+Even if your company does not use ivy, sbt uses a custom layout to
+handle binary compatibility constraints of its own plugins. To ensure
+that these are resolved correctly, simple set up two virtual/proxy
+repositories, one for maven and one for ivy.
+
+Here's an example setup:
+
+.. image:: proxy-ivy-mvn-setup.png
+
+
.. _Archiva: http://archiva.apache.org/
.. _Artifactory: http://www.jfrog.com/home/v_artifactory_opensource_overview
.. _Nexus: http://www.sonatype.org/nexus/
View
BIN src/sphinx/Detailed-Topics/proxy-ivy-mvn-setup.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 88ca4ae

Please sign in to comment.
Something went wrong with that request. Please try again.