Introduction

Welcome to Intershop’s Tutorial Prepare Your Artifact Repository Server. In this tutorial we want to show you how to prepare a local Nexus Artifact Repository server as a central tool to deploy servers in a CI environment.

This tutorial is related to the Video Tutorial - Simple Setup of a Development-System (valid to 7.10).

The setup of a CI infrastructure with CI servers and version control system are not part of this tutorial. The following artifact repository servers are available and work with the Intershop Continous delivery tools: the Sonatype Nexus, JFrog Artifactory and Apache Archiva. In this tutorial we only installed and started the Sonatype Nexus.

Info

In this tutorial we use Sonatype Nexus 2.x.

References

Video Tutorial

Guidance

Tasks

In this tutorial we want to prepare a local artifact repository server that will be used for the deployment of the Intershop Commerce Management (see also: Video Tutorial - Simple Setup of a Development-System (valid to 7.10)).

Walkthrough

For this tutorial we already installed and started the Artifact Repository Sonatype Nexus. Now start with the following:

Open the recipe Recipe - Configure Artifact Repository Server within the Cookbook Cookbook - Setup CI Infrastructure.
Under Configuration Steps you will find a table listing all necessary repositories that need to be created and configured
Start with all proxy repositories (according to 3.3.1.1, 3.3.1.3): Enter the ID, the Name and the Remote Storage Location from Central, JCenter and Intershop. Intershop ivy and intershop maven are no longer relevant.
Note
As of March 31, 2021, JCenter no longer provides new artifacts. Therefore Gradle deprecated the jCenter repository configuration and will remove this in the next major version. Intershop switched for new artifacts also to Maven Central.
What is necessary for the future? Add to your Maven repository configuration parallel to the JCenter configuration a configuration for Maven Central.
You need an authentication for the Intershop.Proxy.Repository -> Login and Username are defined in the Support Contract Details.
Note
Please make sure that Discovery is unchecked in the routing tab.
Create all needed hosted repositories; releases and snapshots already exist. Therefore we only need to create the Distributions repository.
Create the groups repository components and switch the needed repository from Available Repositories to Ordered Group Repositories in the following order: Central, JCenter, Intershop, Releases. If everything is configured correctly every repository is stated as In Service.
To use the Nexus for the intershop deployment, we recommend to create a new Nexus User. How to create this deploy user follow our cookbook (according to 3.3.1.5).
Create the sources from intershop templates to upload specifics to the Nexus.
For this task we use the recipe Recipe - Create Sources From Intershop Templates (according to 5.2.2)
Download the master template zip file: Home - Open Terminal: wget https://github.com/IntershopCommunicationsAG/intershop-cisetup-template/archive/master.zip
Unzip master.zip

Modify the build.gradle file under intershop-cisetup-template-master.

Modify the build.gradle file

setupDirectory = '/home/intershop1/intershop-cisetup-sources'
repoBaseURL = 'http://localhost:8081/nexus/content'
projectName = 'a_responsive'

Open Terminal: ./gradlew intershopCISetupAll
Our next step is to publish the Corporate Distribution on our Nexus.
Open the gradle project located in /home/intershop1/intershop-cisetup-sources/devops/gradle/corporate-distribution and execute a SIMPLE PUBLISH.
Disable the Source Control Management plugin (short SCM) in the build.gradle: disableSCM = true
Execute the following commands with special configuration-parameters:
Execute the following commands:
```
 ./gradlew publish 
 -PrunOnCI=true
 -PreleaseURL=http://localhost:8081/nexus/content/repositories/distributions/ 
 -PrepoUserName=ish_deploy
 -PrepoUserPasswd=intershop
 -PscmVersionExt=RELEASE
```
Info
You will need the URL of the corporate distribution .zip file later in the project as distribution URL in the gradle wrapper properties files.
Publish the already existing oracle project to the Nexus.
Prepare the build of the Cartridge with Oracle JDBC driver libraries.
You can find these libraries from the Oracle download page or from Oracle Maven repository (ojdbc7.jar, ucp.jar and ons.jar)
Copy the files to <setupDirectory>/projects/oracleDriver/3rd_oracle/build//oracleLibs/jars
Open /home/intershop1/intershop-cisetup-sources/projects/oracleDriver/3rd_oracle/gradle and paste the distributionURL from the Nexus in the gradle wrapper properties file.
Go back to /home/intershop1/intershop-cisetup-sources/projects/oracleDriver/3rd_oracle and execute the command: ./gradlew publish -PreleaseURL=http://localhost:8081/nexus/content/repositories/releases/ -PrepoUserName=ish_deploy -PrepoUserPasswd=intershop

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.