Setup Artifact Repository Manager

Elastic Path Commerce is provided as Java source code, and Apache Maven is the tool used to build the application code. This section provides details on the Maven artifact repository manager server, which is an essential component for Elastic Path Commerce builds.

note

The Elastic Path Commerce software build processes requires a Maven artifact repository manager server or service.

If you are using CloudOps for Kubernetes, then a Maven artifact repository manager is installed, pre-configured and ready for use. To learn more about CloudOps for Kubernetes, see Infrastructure Options.

The Maven artifact repository manager:

• Retrieves external Maven dependencies required to build and test Elastic Path Commerce. The Elastic Path Commerce source does not build all of the Maven artifacts that Elastic Path Commerce depends on; additional artifacts are downloaded at build-time by the Maven Repository Manager.
• Optionally hosts Elastic Path Commerce artifacts built by your project team.

Select and Provision the Service

The Maven Project site provides more details about Maven artifact repository managers, and a list of available repository manager technologies.

tip

Elastic Path Commerce customers often use Sonatype Nexus 2. Sonatype Nexus 2 is used as the example in this documentation.

Configure the Maven Repositories

Configure the Maven artifact repostory manager to proxy the required Maven repositories.

Recommended Repository Structure

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.

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

Elastic Path Nexus credentials are required to access the Elastic Path Maven repositories. To request the Elastic Path Nexus credentials, submit an access request ticket.

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

Elastic Path 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.

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.

   

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.