Introduction

Intershop provides an integrated environment for development and production in Microsoft Azure Cloud. All continuous integration processes are preconfigured in a project location in Azure DevOps.

References

• Guide - Access to Docker Images

• Guide - Access to Intershop Docker Images

Azure DevOps Project Setup

Each customer project starts with an organization and a project in Azure DevOps. The project contains prepared source repositories and provides access to the necessary Java artifacts, pipelines and an optional ticket system and wiki system. For container handling two registries are provided - one for Intershop container images and a second one for self-created images.

The CI/CD system is working with a standard configuration.

To access the various resources, you need an Azure account, which is provided by Intershop.

Customer resources in Azure

Development Requirements

The following resources are required on a developer machine:

• Docker Desktop (https://www.docker.com/products/docker-desktop/)

• JDK 17 (https://adoptium.net/de/temurin/releases?version=11)

• Git client

• Azure CLI, see https://docs.microsoft.com/en-us/cli/azure/install-azure-cli

Intershop Commerce Management

• Intershop Studio

Setup details are available in the README of the project template.

Intershop Progressive Web App

• https://nodejs.org/en/

• Angular CLI (https://www.npmjs.com/package/@angular/cli )

• Microsoft Visual Code

For details, refer to PWA - Setup Guide .

Intershop Order Management

• Apache Maven (https://maven.apache.org/install.html)

• Java IDE

For more information, refer to Guide - IOM Setup Blueprint Project.

Start with Intershop Projects

Projects require access to various artifacts - this includes Maven packages as well as container images.

Configure Azure DevOps Account

1. Log in to https://dev.azure.com for your configured organization.

2. Configure a personal access token, see https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows for details.
   The personal access token should be configured to read packages:

   

3. Copy the personal access token to a temporary text file for later use.

4. Configure an SSH public key, see https://docs.microsoft.com/en-us/azure/devops/repos/git/use-ssh-keys-to-authenticate?toc=%2Fazure%2Fdevops%2Forganizations%2Ftoc.json&bc=%2Fazure%2Fdevops%2Forganizations%2Fbreadcrumb%2Ftoc.json&view=azure-devops for details.
   The personal access token is used for your Maven or Gradle configuration.

Configure Access for Container Images

To access the Intershop registry, it is necessary to generate a special token for the Docker login. Do to so, perform the following steps:

1. Open https://docker.tools.intershop.com/.

2. Log in via LOGIN VIA OIDC PROVIDER and use your Intershop Azure account.

3. On the following page, select your profile on the top left.

4. Copy the CLI secret from the dialog.
   For more information see Guide - Access to Intershop Docker Images.

Test Docker Login to Intershop Registry

To test the Docker Login to the Intershop registry, use the following command:

docker login -u <your Azure account> -p <CLI secret>

The response should be:

Login Succeeded

Test Docker Login to your Azure Registry

To test the Docker Login to your Azure registry, use the following command:

az acr login -n <project name without dash>acr.azurecr.io>

The response should be:

Login Succeeded