Working with Ivy

Automatic Settings with Artifactory's Ivy Settings Generator

To begin quickly, you can define credentials and resolver settings using Artifactory's Ivy Settings Generator. This generates a URL resolver suitable for resolution.

In the Artifact Repository Browser of the Artifacts module, select Set Me Up. In the Set Me Up dialog, set Ivy in the Tool field and click "Generate Ivy Settings". You can now specify the repositories you want to configure for Ivy.

Since the Libs Repository field only includes virtual or remote repositories, none of these will be suitable for deployment, and you need to modify the deployment URL to point to a local repository.

Provisioning Dynamic Settings for Users

You can deploy and provision a dynamic settings template for your users.

Once downloaded, settings are generated according to your own logic, and can automatically include user authentication information.

For details, please refer to Provisioning Build Tool Settings under Filtered Resources.

Defining a Manual Resolver 

The IBiblio Resolver

This resolver is only used to resolve dependencies. By default, it assumes artifacts in your repository are laid-out in the popular and standard Maven 2 format (which may not always be the case).

The IBiblio resolver can resolve artifacts from remote Maven 2 HTTP repositories, and if you use version ranges it relies on maven-metadata.xml files in the remote repository to gather information on the available versions.

To use the IBiblio resolver, add the following to your ivysettings.xml file:

<resolvers>
    <ibiblio name="artifactory" m2compatible="true" root="http://localhost:8080/artifactory/libs-releases"/>
</resolvers>

The URL Resolver

The URL resolver can be used to resolve dependencies and/or for deployment of both regular artifacts and Ivy module files.

To publish or resolve artifacts to or from Artifactory, you need to configure a URL resolver with the pattern that matches your target repository layout for both Ivy and artifact files.

For example:

<!-- Authentication required for publishing (deployment). 'Artifactory Realm' is the realm used by Artifactory so don't change it. -->
<credentials host="localhost" realm="Artifactory Realm" username="admin" passwd="password"/>
<resolvers>
    <url name="artifactory-publish">
        <!-- You can use  m2compatible="true" instead of specifying your own pattern -->
        <artifact pattern=
          "http://localhost:8080/artifactory/ivy-local/[organization]/[module]/[revision]/[artifact]-[revision].[ext]"/>
        <ivy pattern="http://localhost:8080/artifactory/ivy-local/[organization]/[module]/[revision]/ivy-[revision].xml" />
    </url>
</resolvers>

Using a Chain Resolver

You can combine resolver definitions under a chain resolver in Ivy which uses a set of sub resolvers to resolve dependencies and for publishing.

For details please refer to the Ivy documentation for  Chain Resolver.

Ivy Modules - ivy.xml

ivy.xml files contain a list of dependency declarations that must be resolved for the build.

In the Artifact Repository Browser of the Artifacts module, you can obtain dependency declaration snippets by selecting either an Ivy module, or a POM artifact, and copying the Ivy Dependency Declaration section into your ivy.xml file.

Ant Build - build.xml

To work with Ivy to resolve dependencies, you need to use <ivy:configure/> in your build.xml file. This will load the Ivy settings from ivysettings.xml.

Artifacts are resolved using <ivy:retrieve/>.

For details please refer to the Ivy documentation for  Ant Tasks.

Publishing to Artifactory

You can use the <ivy:publish> command to configure Ivy to deploy your artifacts into Artifactory using the specified resolver.

For example:

<ivy:publish resolver="artifactory-publish" overwrite="true">
   <!--
   Use overwrite="true" if you wish to overwrite existing artifacts
   and publishivy="false" if you only want to publish artifacts not module descriptors
   -->
   <artifacts/>
</ivy:publish>

Using a Dedicated Settings File for Deployment

If you have specified deployment settings with the required credentials in a dedicated settings file, you can refer to them by assigning a unique ID.

For example, the following code snippet assigns the deployment settings with the id ivy.publish.settings:

<ivy:settings id="ivy.pub.settings" file="publish_to_artifactory_settings.xml"/>

Then, the publishing task points to these settings using the following attribute in the publish element:

settingsRef="ivy.pub.settings"

For details please refer to the Ivy documentation for Ant Tasks.