Quick Start

This document describes steps needed to install Operator Service for Jenkins from Red Hat marketplace


You need to have access to a namespace in which you wish to deploy the operator. For information on registering your cluster and creating a namespace, see Red Hat Marketplace Docs. This must be done prior to operator installation.

Operator installation on RedHat Marketplace

  • On the main menu, click Workspace > My Software > Product > Install Operator.
  • Search for and select Operator Service for Jenkins
  • On the Update Channel section, select an option.
  • On the Approval Strategy section, select either Automatic or Manual. The approval strategy corresponds to how you want to process operator upgrades.
  • On the Target Cluster section:
  • Click the checkbox next to the clusters where you want to install the Operator.
  • For each cluster you selected, under Namespace Scope, on the Select Scope list, select an option.
  • Click Install. It may take several minutes for installation to complete.
  • Once installation is complete, the status will change from Installing to Up to date.
  • For further information, see the Red Hat Marketplace Operator documentation

install operator

Verification of operator installation

  • Once status changes to Up to date, click the vertical ellipses and select Cluster Console.
  • Open the cluster where you installed the product
  • Go to Operators > Installed Operators
  • Select the Namespace or Project you installed on
  • Verify status for the product is Succeeded
  • Click the product name to open details

verify installation of the operator

Deploying Jenkins

  • Once the operator is up and running, you may proceed to deploy a Jenkins instance. To do so, you need to click the operator name and then create a Jenkins CR:

deploying Jenkins

  • Go into YAML view, and you will see the example Jenkins configuration.
  • Check the version of Jenkins image. It can be found under spec.podspec.containers[0].image.
  • If you find version @sha256:(...) there, change it to 4.9.0. Image quay.io/openshift/origin-jenkins:4.9.0 should be used.
  • Click Create and then the Jenkins instance will start.
  • Go to Jenkins tab and wait for Jenkins to report status Ready. It might take several minutes.

Jenkins install verification

  • Once Jenkins is ready, you can navigate to Networking > Routes to see the route that the Operator made for Jenkins. Clicking there will prompt you to login using OpenShift OAuth. After logging, you will be presented with Jenkins UI

Your Hello World Jenkins job

  • Jenkins jobs definitions are declared in the SeedJob CR. To create your first jobs that will persist after Jenkins’ restarts, go to the JenkinsSeedJob tab
  • In the YAML view, paste the example SeedJob:
apiVersion: operator-service.com/v1beta1
kind: JenkinsSeedJob
 name: example-jenkins-seedjob
   operator-service.com/jenkins: example
   url: https://github.com/jenkinsci/kubernetes-operator.git
   branch: master
   targets: "cicd/jobs/*.jenkins"
  • Wait for the SeedJob to report the Ready status
  • Go to Jenkins UI and you will see example jobs:

Jenkins example seedjobs