devops-docker-cx-server is deprecated and won't be developed or maintained further. The repository will be sunsetted soon. If somebody outside in the community would like to take over this repository, feel free to contact us.
A manual, how to setup your Jenkins manually, can be found here: Jenkins Setup
The CX Server is a collection of Dockerfiles for images that can be used in Continuous Delivery (CD) pipelines for SAP development projects. The images are optimized for use with project "Piper" on Jenkins. Docker containers simplify your CD tool setup, encapsulating tools and environments that are required to execute pipeline steps.
If you want to learn how to use project "Piper" please have a look at the documentation. Introductory material and a lot of SAP scenarios not covered by project "Piper" are described in our Continuous Integration Best Practices.
This repository contains Dockerfiles that are designed to run project "Piper" pipelines. Nevertheless, they can also be used flexibly in any custom environment and automation process.
For detailed usage information please check the README.md in the corresponding folder.
The following images are published on hub.docker.com:
| Name | Description | Docker Image |
|---|---|---|
| Jenkins | Preconfigured Jenkins to run project "Piper" pipelines. | ppiper/jenkins-master |
| Jenkinsfile Runner | Jenkinsfile Runner based on ppiper/jenkins-master, allows running a Jenkinsfile without a long-running, stateful Jenkins master. |
ppiper/jenkinsfile-runner |
| Jenkinsfile Runner GitHub Action | GitHub Action for using the Jenkinsfile runner | jenkinsfile-runner-github-action |
| Life Cycle Container | Sidecar image for life-cycle management of the cx-server | ppiper/cx-server-companion |
All images have a Docker tag latest.
Individual images may provide additional tags corresponding to releases.
Existing releases are listed on the GitHub releases page.
Official releases follow the pattern v{VersionNumber}.
Developer documentation for releases is available in the release documentation document.
Information on updating the Jenkins master including the bundled plugins is available in the respective section of the operations guide.
A Docker environment is needed to build and run Docker images. You should be familiar with basic Docker commands to build and run these images. In case you need to fetch the Dockerfiles and this project's sources to build them locally, a Git client is required.
Each individual Dockerfile may have additional requirements. Those requirements are documented with each Dockerfile.
To download and install Docker please follow the instructions at the Docker website according your operating system.
You can consume these images in three different flavors:
-
Build locally and run
Clone this repository, change directories to the desired Dockerfile and build it:
git clone https://github.com/SAP/devops-docker-cx-server cd devops-docker-cx-server/<specific-image> docker build . docker run ...Specific instructions how to run the containers are stored within the same directory.
-
Pull from hub.docker.com
We build the Dockerfiles for your convenience and store them on https://hub.docker.com/.
docker pull <image-name>:<version> docker run ... -
Via project "Piper"
In case you are using project "Piper" you can configure certain steps to use docker images instead of the local Jenkins environment. These steps will automatically pull and run these images.
The cx-server is a toolkit that is developed to manage the lifecycle of the Jenkins server.
In order to use the toolkit, you need a file named cx-server and a configuration file server.cfg.
You can generate these files using the docker command
docker run -it --rm -u $(id -u):$(id -g) -v "${PWD}":/cx-server/mount/ ppiper/cx-server-companion:latest init-cx-serverOnce the files are generated in the current directory, you can launch the below command to start the Jenkins server.
./cx-server startIf you would like to customize the Jenkins, the operations guide will provide more information on this along with the lifecycle management of the Jenkins.
Feel free to open new issues for feature requests, bugs or general feedback on the GitHub issues page of this project.
Read and understand our contribution guidelines before opening a pull request.
Copyright 2017-2021 SAP SE or an SAP affiliate company and devops-docker-cx-server contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.