This collection of Dockerfiles builds the foundation for the Docker images used by the Pipeline for the SAP S/4HANA Cloud SDK. It contains two type of Dockerfiles. The folder s4sdk-jenkins-master contains a Dockerfile for a Jenkins server, which is preconfigured to run the pipeline. The other folders contain Dockerfiles for Docker images which are used in the pipeline to run steps, such as deployments to the SAP Cloud Platform.

In order to run and build the Docker images, you have to install Docker.

To build a Docker image, such as s4sdk-jenkins-master, go to this folder and execute the following command:

 $ docker build -t s4sdk/jenkins-master-image .

Afterwards the image is available and a new container can be spawned with following command:

 $ docker run -p 8080:8080 --name my-jenkins s4sdk/jenkins-master-image

The same applies to all other Dockerfiles.

The SAP S/4HANA Cloud SDK already provides a script called cx-server to avoid these manual steps. It can be found in the same named folder on the root of each SAP S/4HANA Cloud SDK project archetype. Together with the server.cfg file, this is all you need for starting your instance of the SAP S/4HANA Cloud SDK Cx Server.
For instantiating the SAP S/4HANA Cloud SDK Cx Server, you need to provide a suitable host with a Linux operating system and Docker installed. Please also ensure that the user with whom you start the Cx Server belongs to the docker group.

To create a new project using the SDK execute the following command:

 $ mvn archetype:generate -DarchetypeGroupId=com.sap.cloud.s4hana.archetypes -DarchetypeArtifactId=scp-cf-tomee -DarchetypeVersion=RELEASE

In the new project, there is a folder called cx-server. This folder needs to be copied to the future host on which the Cx Server is intended to run.

On the host machine execute the following command in the folder cx-server. This will start the Jenkins server.

 $ ./cx-server start

Currently, there are no known issues.

If you need any support, have any question or have found a bug, please report it as an issue in the repository.

Copyright (c) 2017-2018 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.

Please note that Docker images can contain other software which may be licensed under different licenses. For example, the Docker image s4sdk/docker-neo-cli contains the SAP Cloud Platform Tools for Neo. These tools are licensed under the SAP DEVELOPER LICENSE AGREEMENT. This License file is also included in the sdk folder in the Docker image. For any usage of built Docker images please make sure to check the licenses of the artifacts contained in the images.