Skip to main content
Version: 8.2.x

Maven Repository Manager

Overview​

This section provides details on the Maven Repository Manager. The Maven Repository Manager is an essential component for team development of Maven based projects. The Maven Project site explains why and provides a list of available Repository Managers.

The release package does not contain all of the Maven artifacts that Elastic Path products depend on. The additional artifacts are available in Elastic Path Maven Repository.

important

Your Maven Repository Manager must be installed and running before you can complete the following steps.

This section provides information on the repository structure for Elastic Path projects. Repositories are collections of the artifacts you reuse to build your software. The image below shows the repository structure for Elastic Path projects.

Recommended repository structure in Nexus

In the above image, the main repository group is the <project> EP Repository Group. You can get all of the dependencies to build Elastic Path from this group. Continuous integration builds deploy generated artifacts to either the <project> EP Snapshots or the <project> EP Releases repository, depending on whether the artifacts have SNAPSHOT or Release versions.

Proxy External Repositories​

This section provides the proxy information for external Maven repositories.

note

Maven credentials are required to access the Elastic Path Maven repositories. To learn how to request Maven credentials, see https://community.elasticpath.com/product-support/p/nexus-maven-repo-access.

Maven Central​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repo1.maven.org/maven2/
  • Authentication: None

Elastic Path Public​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.elasticpath.com/nexus/content/repositories/public/
  • Authentication: Yes - Elastic Path Maven Repository Credentials

Elastic Path Cortex​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.elasticpath.com/nexus/content/repositories/cortex/
  • Authentication: Yes - Elastic Path Maven Repository Credentials

Self-Managed Commerce Engine​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.elasticpath.com/nexus/content/repositories/commerce-engine/
  • Authentication: Yes - Elastic Path Maven Repository Credentials

Elastic Path Accelerators​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.elasticpath.com/nexus/content/repositories/accelerators/
  • Authentication: Yes - Elastic Path Maven Repository Credentials

Java Net Repository For Maven​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://maven.java.net/content/repositories/releases/
  • Authentication: None

Sonatype​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.sonatype.org/content/groups/forge
  • Authentication: None

Springsource Bundles​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://repository.springsource.com/maven/bundles/external
  • Authentication: None

Springsource Milestone​

  • Repository Format: Maven2
  • Repository Policy: Release
  • Repository URL: https://maven.springframework.org/milestone/
  • Authentication: None

Configuring Local Repositories and Groups​

This section provides instructions to create local repositories and groups and build the repository hierarchy, after you configure all external proxies.

  1. Create a hosted repository with a snapshot policy as in the following example:

    <project> EP Snapshots

  2. Create a hosted repository with a release policy as in the following example:

    <project> EP Releases.

  3. Create a Proxy Repository Group.

  4. Add all external proxies repositories to it in the order defined in the Proxy external repositories section.

  5. Create a <project> EP Repository Group.

  6. Add the hosted repositories and the Proxy Repository Group created in step 3 to the group created in step 5.

Setting Elastic Path Maven Repository Credentials​

Access to the Elastic Path repositories require a valid username and password from Elastic Path.

When Nexus starts, click Repositories. The Elastic Path repositories have a status of In Service - Remote Automatically Blocked and Unavailable.

Elastic Path Maven Repositories in Nexus

You must manually enter the username and password for each repository:

  1. Select the repository from the Repositories list.

  2. Click the Configuration tab.

  3. Click the Authentication (optional) box.

    The username and password panel appears.

  4. Enter the Elastic Path username and password.

  5. Click Save.

  6. Click Refresh.

    If the credentials are valid, the repository status changes to In Service.

    Configuring authentication in Nexus for Elastic Path Repositories

  7. Make a note of the repository path for the <project> EP Repository Group. You will need this URL when you update the settings.xml file.

User Accounts​

A user account with Maven artifact deployment privileges must be created for use by the continuous integration server to deploy build artifacts.