Related Documents
Document Properties
Kbid
287Q77
Last Modified
09-Jul-2021
Added to KB
09-Oct-2018
Public Access
Everyone
Status
Online
Doc Type
Video Tutorials
Product
  • ICM 7.7
  • ICM 7.8
  • ICM 7.9
  • ICM 7.10

Video Tutorial - Prepare Your Artifact Repository Server

Product Version

7.6

Product To Version


Status

final

1 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.

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.

1.1 References

2 Video Tutorial

3 Guidance

3.1 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).

3.2 Walkthrough

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

  1. Open the recipe Recipe - Configure Artifact Repository Server within the Cookbook Cookbook - Setup CI Infrastructure.
  2. Under Configuration Steps you will find a table listing all necessary repositories that need to be created and configured
  3. 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 JCenter and Intershop. Intershop ivy and intershop maven are no longer relevant.
  4. 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.

  5. Create all needed hosted repositories; releases and snapshots already exist. Therefore we only need to create the Distributions repository.
  6. Create the groups repository components and switch the needed repository from Available Repositories to Ordered Group Repositories in the following order: JCenter, Intershop, Releases, Central. If everything is configured correctly every repository is stated as In Service.
  7. 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).
  8. Create the sources from intershop templates to upload specifics to the Nexus.
  9. For this task we use the recipe Recipe - Create Sources From Intershop Templates (according to 5.2.2)
  10. Download the master template zip file: Home - Open Terminal: wget https://github.com/IntershopCommunicationsAG/intershop-cisetup-template/archive/master.zip
  11. Unzip master.zip
  12. 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'
  13. Open Terminal: ./gradlew intershopCISetupAll
  14. Our next step is to publish the Corporate Distribution on our Nexus.
  15. Open the gradle project located in /home/intershop1/intershop-cisetup-sources/devops/gradle/corporate-distribution and execute a SIMPLE PUBLISH.
  16. Disable the Source Control Management plugin (short SCM) in the build.gradle: disableSCM = true
  17. 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.

  18. Publish the already existing oracle project to the Nexus.

  19. Prepare the build of the Cartridge with Oracle JDBC driver libraries.

  20. You can find these libraries from the Oracle download page or from Oracle Maven repository (ojdbc7.jar, ucp.jar and ons.jar)
  21. Copy the files to <setupDirectory>/projects/oracleDriver/3rd_oracle/build//oracleLibs/jars
  22. Open /home/intershop1/intershop-cisetup-sources/projects/oracleDriver/3rd_oracle/gradle and paste the distributionURL from the Nexus in the gradle wrapper properties file.
  23. 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.

Customer Support
Knowledge Base
Product Resources
Tickets