Regenerate website
This commit is contained in:
		
							parent
							
								
									55cfdf5687
								
							
						
					
					
						commit
						d43c341f39
					
				|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -593,7 +599,10 @@ | |||
| <ul> | ||||
| <li><a href="#prerequisites">Prerequisites</a></li> | ||||
| <li><a href="#clone-repository-and-download-dependencies">Clone repository and download dependencies</a></li> | ||||
| <li><a href="#build-and-run-with-a-minikube">Build and run with a minikube</a></li> | ||||
| <li><a href="#build-and-run-with-a-minikube">Build and run with a minikube</a> | ||||
| <ul> | ||||
| <li><a href="#debug-jenkins-operator">Debug Jenkins Operator</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#build-and-run-with-a-remote-kubernetes-cluster">Build and run with a remote Kubernetes cluster</a></li> | ||||
| <li><a href="#testing">Testing</a> | ||||
| <ul> | ||||
|  | @ -605,6 +614,7 @@ | |||
| <li><a href="#when-pkg-apis-jenkinsio-jenkins-types-go-has-changed">When <code>pkg/apis/jenkinsio/*/jenkins_types.go</code> has changed</a></li> | ||||
| <li><a href="#getting-the-jenkins-url-and-basic-credentials">Getting the Jenkins URL and basic credentials</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#self-learning">Self-learning</a></li> | ||||
| </ul></li> | ||||
| </ul> | ||||
| </nav> | ||||
|  | @ -669,11 +679,165 @@ make go-dependencies</code></pre></div> | |||
| <h2 id="build-and-run-with-a-minikube">Build and run with a minikube</h2> | ||||
| 
 | ||||
| <p>Build and run <strong>Jenkins Operator</strong> locally:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">make build minikube-run</code></pre></div> | ||||
| <p>Once minikube and <strong>Jenkins Operator</strong> are up and running, apply Jenkins custom resource:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl apply -f deploy/crds/jenkins_v1alpha2_jenkins_cr.yaml | ||||
| kubectl get jenkins -o yaml | ||||
| kubectl get po</code></pre></div> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">make build minikube-run | ||||
| 
 | ||||
| INFO<span style="color:#ce5c00;font-weight:bold">[</span><span style="color:#0000cf;font-weight:bold">0000</span><span style="color:#ce5c00;font-weight:bold">]</span> Running deepcopy code-generation <span style="color:#204a87;font-weight:bold">for</span> Custom Resource group versions: <span style="color:#ce5c00;font-weight:bold">[</span>jenkins:<span style="color:#ce5c00;font-weight:bold">[</span>v1alpha2<span style="color:#ce5c00;font-weight:bold">]</span>, <span style="color:#ce5c00;font-weight:bold">]</span>  | ||||
| INFO<span style="color:#ce5c00;font-weight:bold">[</span><span style="color:#0000cf;font-weight:bold">0005</span><span style="color:#ce5c00;font-weight:bold">]</span> Code-generation complete.                     | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:51	Version: v0.4.0 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:52	Git commit: 4ffc58e-dirty | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:53	Go Version: go1.13.1 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:54	Go OS/Arch: linux/amd64 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:55	operator-sdk Version: v0.15.1 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.520+0200	INFO	controller-jenkins	manager/main.go:80	Watch namespace: default | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.527+0200	INFO	leader	leader/leader.go:46	Trying to become the leader. | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.527+0200	INFO	leader	leader/leader.go:51	Skipping leader election<span style="color:#000;font-weight:bold">;</span> not running in a cluster. | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.887+0200	INFO	controller-runtime.metrics	metrics/listener.go:40	metrics server is starting to listen	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"addr"</span>: <span style="color:#4e9a06">"0.0.0.0:8383"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.887+0200	INFO	controller-jenkins	manager/main.go:105	Registering Components. | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:26.897+0200	WARN	controller-jenkins	manager/main.go:138	Could not generate and serve custom resource metrics	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"error"</span>: <span style="color:#4e9a06">"namespace not found for current environment"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.250+0200	INFO	metrics	metrics/metrics.go:55	Skipping metrics Service creation<span style="color:#000;font-weight:bold">;</span> not running in a cluster. | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.601+0200	WARN	controller-jenkins	manager/main.go:157	Could not create ServiceMonitor object	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"error"</span>: <span style="color:#4e9a06">"no ServiceMonitor registered with the API"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.601+0200	WARN	controller-jenkins	manager/main.go:161	Install prometheus-operator in your cluster to create ServiceMonitor objects	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"error"</span>: <span style="color:#4e9a06">"no ServiceMonitor registered with the API"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.601+0200	INFO	controller-jenkins	manager/main.go:165	Starting the Cmd. | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.601+0200	INFO	controller-runtime.manager	manager/internal.go:356	starting metrics server	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"path"</span>: <span style="color:#4e9a06">"/metrics"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.601+0200	INFO	controller-runtime.controller	controller/controller.go:164	Starting EventSource	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: jenkins.io/v1alpha2, Kind=Jenkins"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.702+0200	INFO	controller-runtime.controller	controller/controller.go:164	Starting EventSource	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=Pod"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.803+0200	INFO	controller-runtime.controller	controller/controller.go:164	Starting EventSource	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=Secret"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.903+0200	INFO	controller-runtime.controller	controller/controller.go:164	Starting EventSource	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=Secret"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:27.903+0200	INFO	controller-runtime.controller	controller/controller.go:164	Starting EventSource	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=ConfigMap"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:28.005+0200	INFO	controller-runtime.controller	controller/controller.go:171	Starting Controller	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:52:28.005+0200	INFO	controller-runtime.controller	controller/controller.go:190	Starting workers	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"controller"</span>: <span style="color:#4e9a06">"jenkins-controller"</span>, <span style="color:#4e9a06">"worker count"</span>: <span style="color:#0000cf;font-weight:bold">1</span><span style="color:#ce5c00;font-weight:bold">}</span></code></pre></div><div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl apply -f deploy/crds/jenkins_v1alpha2_jenkins_cr.yaml | ||||
| 
 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:404	Setting default Jenkins container <span style="color:#204a87">command</span>	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:409	Setting default Jenkins container JAVA_OPTS environment variable	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:417	Setting default operator plugins	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:436	Setting default Jenkins master service	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:449	Setting default Jenkins slave service	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.153+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:479	Setting default Jenkins API settings	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.158+0200	INFO	controller-jenkins	jenkins/handler.go:89	*v1alpha2.Jenkins/example has been updated	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.562+0200	INFO	controller-jenkins	base/pod.go:161	Creating a new Jenkins Master Pod default/jenkins-example	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.575+0200	INFO	controller-jenkins	base/reconcile.go:528	The Admission controller has changed the Jenkins master pod spec.securityContext, changing the Jenkinc CR spec.master.securityContext to <span style="color:#4e9a06">'&PodSecurityContext{SELinuxOptions:nil,RunAsUser:nil,RunAsNonRoot:nil,SupplementalGroups:[],FSGroup:nil,RunAsGroup:nil,Sysctls:[]Sysctl{},WindowsOptions:nil,}'</span>	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:56:40.584+0200	INFO	controller-jenkins	jenkins/handler.go:89	*v1alpha2.Jenkins/example has been updated	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:59:40.409+0200	INFO	controller-jenkins	base/reconcile.go:466	Generating Jenkins API token <span style="color:#204a87;font-weight:bold">for</span> operator	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:59:40.410+0200	WARN	controller-jenkins	jenkins/jenkins_controller.go:171	Reconcile loop failed: couldn<span style="color:#4e9a06">'t init Jenkins API client: Get http://192.168.99.100:32380/api/json: dial tcp 192.168.99.100:32380: connect: connection refused	{"cr": "example"} | ||||
| </span><span style="color:#4e9a06">2020-04-27T09:59:40.455+0200	INFO	controller-jenkins	base/reconcile.go:466	Generating Jenkins API token for operator	{"cr": "example"} | ||||
| </span><span style="color:#4e9a06">2020-04-27T09:59:41.415+0200	INFO	controller-jenkins	groovy/groovy.go:145	base-groovy ConfigMap '</span>jenkins-operator-base-configuration-example<span style="color:#4e9a06">' name '</span><span style="color:#0000cf;font-weight:bold">1</span>-basic-settings.groovy<span style="color:#4e9a06">' running groovy script	{"cr": "example"} | ||||
| </span><span style="color:#4e9a06">... | ||||
| </span><span style="color:#4e9a06">2020-04-27T09:59:49.030+0200	INFO	controller-jenkins	groovy/groovy.go:145	base-groovy ConfigMap '</span>jenkins-operator-base-configuration-example<span style="color:#4e9a06">' name '</span><span style="color:#0000cf;font-weight:bold">8</span>-disable-job-dsl-script-approval.groovy<span style="color:#a40000">'</span> running groovy script	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| 
 | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:59:49.257+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:289	Base configuration phase is complete, took 3m9s	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T09:59:51.165+0200	INFO	controller-jenkins	seedjobs/seedjobs.go:232	Waiting <span style="color:#204a87;font-weight:bold">for</span> Seed Job Agent <span style="color:#4e9a06">`</span>seed-job-agent<span style="color:#4e9a06">`</span>...	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| ... | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T10:00:03.886+0200	INFO	controller-jenkins	seedjobs/seedjobs.go:232	Waiting <span style="color:#204a87;font-weight:bold">for</span> Seed Job Agent <span style="color:#4e9a06">`</span>seed-job-agent<span style="color:#4e9a06">`</span>...	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span> | ||||
| <span style="color:#0000cf;font-weight:bold">2020</span>-04-27T10:00:06.140+0200	INFO	controller-jenkins	jenkins/jenkins_controller.go:338	User configuration phase is complete, took 3m26s	<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"cr"</span>: <span style="color:#4e9a06">"example"</span><span style="color:#ce5c00;font-weight:bold">}</span></code></pre></div> | ||||
| <p>Two log lines says that Jenkins Operator works correctly:</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><code>Base configuration phase is complete</code> - ensures manifests, Jenkins pod, Jenkins configuration and Jenkins API token<br /></li> | ||||
| <li><code>User configuration phase is complete</code> - ensures Jenkins restore, backup and seed jobs along with user configuration</li> | ||||
| </ul> | ||||
| 
 | ||||
| <blockquote> | ||||
| <p>Details about base and user phase can be found <a href="https://jenkinsci.github.io/kubernetes-operator/docs/how-it-works/architecture-and-design/" target="_blank">here</a>.</p> | ||||
| </blockquote> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl get jenkins -o yaml | ||||
| 
 | ||||
| apiVersion: v1 | ||||
| items: | ||||
| - apiVersion: jenkins.io/v1alpha2 | ||||
|   kind: Jenkins | ||||
|   metadata: | ||||
|     ... | ||||
|   spec: | ||||
|     backup: | ||||
|       action: <span style="color:#ce5c00;font-weight:bold">{}</span> | ||||
|       containerName: <span style="color:#4e9a06">""</span> | ||||
|       interval: <span style="color:#0000cf;font-weight:bold">0</span> | ||||
|       makeBackupBeforePodDeletion: <span style="color:#204a87">false</span> | ||||
|     configurationAsCode: | ||||
|       configurations: null | ||||
|       secret: | ||||
|         name: <span style="color:#4e9a06">""</span> | ||||
|     groovyScripts: | ||||
|       configurations: null | ||||
|       secret: | ||||
|         name: <span style="color:#4e9a06">""</span> | ||||
|     jenkinsAPISettings: | ||||
|       authorizationStrategy: createUser | ||||
|     master: | ||||
|       basePlugins: | ||||
|         ... | ||||
|       - command: | ||||
|         - bash | ||||
|         - -c | ||||
|         - /var/jenkins/scripts/init.sh <span style="color:#ce5c00;font-weight:bold">&&</span> <span style="color:#204a87">exec</span> /sbin/tini -s -- /usr/local/bin/jenkins.sh | ||||
|         env: | ||||
|         - name: JAVA_OPTS | ||||
|           value: -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap | ||||
|             -XX:MaxRAMFraction<span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#0000cf;font-weight:bold">1</span> -Djenkins.install.runSetupWizard<span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#204a87">false</span> -Djava.awt.headless<span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#204a87">true</span> | ||||
|         image: jenkins/jenkins:lts | ||||
|         imagePullPolicy: Always | ||||
|         livenessProbe: | ||||
|          ... | ||||
|         name: jenkins-master | ||||
|         readinessProbe: | ||||
|          ... | ||||
|         resources: | ||||
|           limits: | ||||
|             cpu: 1500m | ||||
|             memory: 3Gi | ||||
|           requests: | ||||
|             cpu: <span style="color:#4e9a06">"1"</span> | ||||
|             memory: 500Mi | ||||
|       disableCSRFProtection: <span style="color:#204a87">false</span> | ||||
|       securityContext: <span style="color:#ce5c00;font-weight:bold">{}</span> | ||||
|     restore: | ||||
|       action: <span style="color:#ce5c00;font-weight:bold">{}</span> | ||||
|       containerName: <span style="color:#4e9a06">""</span> | ||||
|     seedJobs: | ||||
|     - additionalClasspath: <span style="color:#4e9a06">""</span> | ||||
|       bitbucketPushTrigger: <span style="color:#204a87">false</span> | ||||
|       buildPeriodically: <span style="color:#4e9a06">""</span> | ||||
|       description: Jenkins Operator repository | ||||
|       failOnMissingPlugin: <span style="color:#204a87">false</span> | ||||
|       githubPushTrigger: <span style="color:#204a87">false</span> | ||||
|       id: jenkins-operator | ||||
|       ignoreMissingFiles: <span style="color:#204a87">false</span> | ||||
|       pollSCM: <span style="color:#4e9a06">""</span> | ||||
|       repositoryBranch: master | ||||
|       repositoryUrl: https://github.com/jenkinsci/kubernetes-operator.git | ||||
|       targets: cicd/jobs/*.jenkins | ||||
|       unstableOnDeprecation: <span style="color:#204a87">false</span> | ||||
|     service: | ||||
|       port: <span style="color:#0000cf;font-weight:bold">8080</span> | ||||
|       type: NodePort | ||||
|     serviceAccount: <span style="color:#ce5c00;font-weight:bold">{}</span> | ||||
|     slaveService: | ||||
|       port: <span style="color:#0000cf;font-weight:bold">50000</span> | ||||
|       type: ClusterIP | ||||
|   status: | ||||
|     appliedGroovyScripts: | ||||
|     - configurationType: base-groovy | ||||
|       hash: <span style="color:#000">2ownqpRyBjQYmzTRttUx7axok3CKe2E45frI5iRwH0w</span><span style="color:#ce5c00;font-weight:bold">=</span> | ||||
|       name: <span style="color:#0000cf;font-weight:bold">1</span>-basic-settings.groovy | ||||
|       source: jenkins-operator-base-configuration-example | ||||
|         ... | ||||
|     baseConfigurationCompletedTime: <span style="color:#4e9a06">"2020-04-27T07:59:49Z"</span> | ||||
|     createdSeedJobs: | ||||
|     - jenkins-operator | ||||
|     operatorVersion: v0.4.0 | ||||
|     provisionStartTime: <span style="color:#4e9a06">"2020-04-27T07:56:40Z"</span> | ||||
|     userAndPasswordHash: kAeBnhHKU3LZuw+uo9oHILB59kAFSGDUbHwCSDgtMnE<span style="color:#ce5c00;font-weight:bold">=</span> | ||||
|     userConfigurationCompletedTime: <span style="color:#4e9a06">"2020-04-27T08:00:06Z"</span> | ||||
| kind: List | ||||
| metadata: | ||||
|   resourceVersion: <span style="color:#4e9a06">""</span> | ||||
|   selfLink: <span style="color:#4e9a06">""</span></code></pre></div><div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl get po | ||||
| 
 | ||||
| NAME                                      READY   STATUS    RESTARTS   AGE | ||||
| jenkins-example                           <span style="color:#0000cf;font-weight:bold">1</span>/1     Running   <span style="color:#0000cf;font-weight:bold">0</span>          15m | ||||
| seed-job-agent-example-56569459c9-l69qf   <span style="color:#0000cf;font-weight:bold">1</span>/1     Running   <span style="color:#0000cf;font-weight:bold">0</span>          12m</code></pre></div> | ||||
| <h3 id="debug-jenkins-operator">Debug Jenkins Operator</h3> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">make build minikube-run <span style="color:#000">OPERATOR_EXTRA_ARGS</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#4e9a06">"--debug"</span></code></pre></div> | ||||
| <h2 id="build-and-run-with-a-remote-kubernetes-cluster">Build and run with a remote Kubernetes cluster</h2> | ||||
| 
 | ||||
| <p>You can also run the controller locally and make it listen to a remote Kubernetes server.</p> | ||||
|  | @ -708,6 +872,15 @@ make e2e</code></pre></div> | |||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">minikube service jenkins-operator-http-<cr_name> --url | ||||
| kubectl get secret jenkins-operator-credentials-<cr_name> -o <span style="color:#4e9a06">'jsonpath={.data.user}'</span> <span style="color:#000;font-weight:bold">|</span> base64 -d | ||||
| kubectl get secret jenkins-operator-credentials-<cr_name> -o <span style="color:#4e9a06">'jsonpath={.data.password}'</span> <span style="color:#000;font-weight:bold">|</span> base64 -d</code></pre></div> | ||||
| <h2 id="self-learning">Self-learning</h2> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p><a href="https://www.youtube.com/watch?v=8_DaCcRMp5I" target="_blank">Tutorial: Deep Dive into the Operator Framework for… Melvin Hillsman, Michael Hrivnak, & Matt Dorn | ||||
| </a></p></li> | ||||
| 
 | ||||
| <li><p><a href="https://www.katacoda.com/openshift/courses/operatorframework" target="_blank">Operator Framework Training By OpenShift</a></p></li> | ||||
| </ul> | ||||
| 
 | ||||
|         <div class="section-index"> | ||||
|      | ||||
|      | ||||
|  | @ -787,6 +960,8 @@ kubectl get secret jenkins-operator-credentials-<cr_name> -o <span style=" | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -770,6 +776,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|      | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -34,7 +34,7 @@ | |||
| 
 | ||||
| <meta itemprop="datePublished" content="2020-04-13T00:00:00+00:00" /> | ||||
| <meta itemprop="dateModified" content="2020-04-13T00:00:00+00:00" /> | ||||
| <meta itemprop="wordCount" content="726"> | ||||
| <meta itemprop="wordCount" content="747"> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -609,6 +615,7 @@ | |||
| <li><a href="#configure-ssh-authentication">Configure SSH authentication</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#username-password-authentication">Username & password authentication</a></li> | ||||
| <li><a href="#external-authentication">External authentication</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#http-proxy-for-downloading-plugins">HTTP Proxy for downloading plugins</a></li> | ||||
| <li><a href="#pulling-docker-images-from-private-repositories">Pulling Docker images from private repositories</a> | ||||
|  | @ -877,6 +884,10 @@ stringData: | |||
|   password: password_or_token | ||||
| </code></pre> | ||||
| 
 | ||||
| <h3 id="external-authentication">External authentication</h3> | ||||
| 
 | ||||
| <p>You can use <code>external</code> credential type if you want to configure authentication using Configuration As Code or Groovy Script.</p> | ||||
| 
 | ||||
| <h2 id="http-proxy-for-downloading-plugins">HTTP Proxy for downloading plugins</h2> | ||||
| 
 | ||||
| <p>To use forwarding proxy with an operator to download plugins you need to add the following environment variable to Jenkins Custom Resource (CR), e.g.:</p> | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -34,7 +34,7 @@ | |||
| 
 | ||||
| <meta itemprop="datePublished" content="2020-04-13T00:00:00+00:00" /> | ||||
| <meta itemprop="dateModified" content="2020-04-13T00:00:00+00:00" /> | ||||
| <meta itemprop="wordCount" content="253"> | ||||
| <meta itemprop="wordCount" content="309"> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -598,11 +604,15 @@ | |||
| <ul> | ||||
| <li> | ||||
| <ul> | ||||
| <li><a href="#how-to-customize-jenkins">How to customize Jenkins</a> | ||||
| <ul> | ||||
| <li> | ||||
| <ul> | ||||
| <li><a href="#using-secrets-from-a-groovy-script">Using secrets from a Groovy script</a></li> | ||||
| <li><a href="#install-plugins">Install plugins</a></li> | ||||
| <li><a href="#apply-plugin-s-config">Apply plugin’s config</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#install-plugins">Install Plugins</a></li> | ||||
| </ul></li> | ||||
| <li><a href="#how-to-use-secrets-from-a-groovy-scripts">How to use secrets from a Groovy scripts</a></li> | ||||
| </ul></li> | ||||
| </ul> | ||||
| </nav> | ||||
|  | @ -661,11 +671,72 @@ | |||
| 	<div class="lead">How to customize Jenkins</div> | ||||
| 	 | ||||
| 
 | ||||
| <p>Jenkins can be customized using groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||
| 
 | ||||
| <p>Jenkins can be customized with plugins. | ||||
| Plugin’s configuration is applied as groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| Any plugin working for Jenkins can be installed by the Jenkins Operator.</p> | ||||
| 
 | ||||
| <p>Pre-installed plugins: | ||||
| * configuration-as-code v1.38 | ||||
| * git v4.2.2 | ||||
| * job-dsl v1.77 | ||||
| * kubernetes-credentials-provider v0.13 | ||||
| * kubernetes v1.25.2 | ||||
| * workflow-aggregator v2.6 | ||||
| * workflow-job v2.38</p> | ||||
| 
 | ||||
| <p>Rest of the plugins can be found in <a href="https://plugins.jenkins.io/" target="_blank">plugins repository</a>.</p> | ||||
| 
 | ||||
| <h4 id="install-plugins">Install plugins</h4> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"2.34"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"2.6"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.76"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.29"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.19"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restart.</p> | ||||
| 
 | ||||
| <h4 id="apply-plugin-s-config">Apply plugin’s config</h4> | ||||
| 
 | ||||
| <p>By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| Then you must reference the <strong><code>ConfigMap</code></strong> in the <strong>Jenkins</strong> pod customization file in <code>spec.groovyScripts</code> or <code>spec.configurationAsCode</code></p> | ||||
| 
 | ||||
| <p>For example create a <strong><code>ConfigMap</code></strong> with name <code>jenkins-operator-user-configuration</code>. Then, modify the <strong>Jenkins</strong> manifest to look like this:</p> | ||||
| <p>Create a <strong><code>ConfigMap</code></strong> with specific name (eg. <code>jenkins-operator-user-configuration</code>). Then, modify the <strong>Jenkins</strong> manifest:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
|  | @ -714,7 +785,7 @@ Then you must reference the <strong><code>ConfigMap</code></strong> in the <stro | |||
| <p>If you want to correct your configuration you can edit it while the <strong>Jenkins Operator</strong> is running. | ||||
| Jenkins will reconcile and apply the new configuration.</p> | ||||
| 
 | ||||
| <h3 id="using-secrets-from-a-groovy-script">Using secrets from a Groovy script</h3> | ||||
| <h2 id="how-to-use-secrets-from-a-groovy-scripts">How to use secrets from a Groovy scripts</h2> | ||||
| 
 | ||||
| <p>If you configured <code>spec.groovyScripts.secret.name</code>, then this secret is available to use from map Groovy scripts. | ||||
| The secrets are loaded to <code>secrets</code> map.</p> | ||||
|  | @ -770,49 +841,6 @@ The secrets are loaded to <code>secrets</code> map.</p> | |||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>systemMessage<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>${SYSTEM_MESSAGE}</code></pre></div> | ||||
| <p>After this, you should see the <code>Hello world</code> system message from the <strong>Jenkins</strong> homepage.</p> | ||||
| 
 | ||||
| <h2 id="install-plugins">Install Plugins</h2> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"2.34"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"2.6"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.76"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.29"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">"1.19"</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restarts.</p> | ||||
| 
 | ||||
| 	 | ||||
| 	 | ||||
| 	<div class="text-muted mt-5 pt-3 border-top">Last modified April 13, 2020 | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page  active" id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -778,6 +784,16 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|                 <div class="entry"> | ||||
|                     <h5> | ||||
|                         <a href="https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|                     </h5> | ||||
|                     <p>Additional configuration for OpenShift | ||||
| </p> | ||||
|                 </div> | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -306,6 +306,10 @@ stringData: | |||
|   password: password_or_token | ||||
| </code></pre> | ||||
| 
 | ||||
| <h3 id="external-authentication">External authentication</h3> | ||||
| 
 | ||||
| <p>You can use <code>external</code> credential type if you want to configure authentication using Configuration As Code or Groovy Script.</p> | ||||
| 
 | ||||
| <h2 id="http-proxy-for-downloading-plugins">HTTP Proxy for downloading plugins</h2> | ||||
| 
 | ||||
| <p>To use forwarding proxy with an operator to download plugins you need to add the following environment variable to Jenkins Custom Resource (CR), e.g.:</p> | ||||
|  | @ -404,11 +408,72 @@ stringData: | |||
|          | ||||
|          | ||||
| 
 | ||||
| <p>Jenkins can be customized using groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||
| 
 | ||||
| <p>Jenkins can be customized with plugins. | ||||
| Plugin&rsquo;s configuration is applied as groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| Any plugin working for Jenkins can be installed by the Jenkins Operator.</p> | ||||
| 
 | ||||
| <p>Pre-installed plugins: | ||||
| * configuration-as-code v1.38 | ||||
| * git v4.2.2 | ||||
| * job-dsl v1.77 | ||||
| * kubernetes-credentials-provider v0.13 | ||||
| * kubernetes v1.25.2 | ||||
| * workflow-aggregator v2.6 | ||||
| * workflow-job v2.38</p> | ||||
| 
 | ||||
| <p>Rest of the plugins can be found in <a href="https://plugins.jenkins.io/" target="_blank">plugins repository</a>.</p> | ||||
| 
 | ||||
| <h4 id="install-plugins">Install plugins</h4> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.34&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.6&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.76&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.29&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.19&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restart.</p> | ||||
| 
 | ||||
| <h4 id="apply-plugin-s-config">Apply plugin&rsquo;s config</h4> | ||||
| 
 | ||||
| <p>By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| Then you must reference the <strong><code>ConfigMap</code></strong> in the <strong>Jenkins</strong> pod customization file in <code>spec.groovyScripts</code> or <code>spec.configurationAsCode</code></p> | ||||
| 
 | ||||
| <p>For example create a <strong><code>ConfigMap</code></strong> with name <code>jenkins-operator-user-configuration</code>. Then, modify the <strong>Jenkins</strong> manifest to look like this:</p> | ||||
| <p>Create a <strong><code>ConfigMap</code></strong> with specific name (eg. <code>jenkins-operator-user-configuration</code>). Then, modify the <strong>Jenkins</strong> manifest:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
|  | @ -457,7 +522,7 @@ Then you must reference the <strong><code>ConfigMap</code>< | |||
| <p>If you want to correct your configuration you can edit it while the <strong>Jenkins Operator</strong> is running. | ||||
| Jenkins will reconcile and apply the new configuration.</p> | ||||
| 
 | ||||
| <h3 id="using-secrets-from-a-groovy-script">Using secrets from a Groovy script</h3> | ||||
| <h2 id="how-to-use-secrets-from-a-groovy-scripts">How to use secrets from a Groovy scripts</h2> | ||||
| 
 | ||||
| <p>If you configured <code>spec.groovyScripts.secret.name</code>, then this secret is available to use from map Groovy scripts. | ||||
| The secrets are loaded to <code>secrets</code> map.</p> | ||||
|  | @ -513,49 +578,6 @@ The secrets are loaded to <code>secrets</code> map.</p> | |||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>systemMessage<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>${SYSTEM_MESSAGE}</code></pre></div> | ||||
| <p>After this, you should see the <code>Hello world</code> system message from the <strong>Jenkins</strong> homepage.</p> | ||||
| 
 | ||||
| <h2 id="install-plugins">Install Plugins</h2> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.34&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.6&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.76&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.29&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.19&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restarts.</p> | ||||
| 
 | ||||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|  | @ -871,7 +893,7 @@ the number of backups under control, e.g. Cloud Formation fragment:</p> | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       slack: | ||||
|  | @ -891,7 +913,7 @@ spec: | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       teams: | ||||
|  | @ -909,7 +931,7 @@ spec: | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       mailgun: | ||||
|  | @ -927,7 +949,7 @@ spec: | |||
| <p>As you see there is two debugging options:</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p><code>loggingLevel</code> (warning/info) - Set level of messages to send.</p></li> | ||||
| <li><p><code>level</code> (warning/info) - Set level of messages to send.</p></li> | ||||
| 
 | ||||
| <li><p><code>verbose</code> - Print stacktrace and additional error messages</p></li> | ||||
| </ul> | ||||
|  | @ -941,7 +963,7 @@ For example you will send notifications to Slack and Teams.</p> | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: nslack | ||||
|       slack: | ||||
|  | @ -949,7 +971,7 @@ spec: | |||
|           secret: | ||||
|             name: &lt;secret_name&gt; | ||||
|           key: &lt;key&gt; | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: nteams | ||||
|       teams: | ||||
|  | @ -962,6 +984,109 @@ spec: | |||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|     <item> | ||||
|       <title>Docs: OpenShift</title> | ||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/</link> | ||||
|       <pubDate>Wed, 29 Apr 2020 00:00:00 +0000</pubDate> | ||||
|        | ||||
|       <guid>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/</guid> | ||||
|       <description> | ||||
|          | ||||
|          | ||||
|          | ||||
| 
 | ||||
| <h2 id="securitycontext">SecurityContext</h2> | ||||
| 
 | ||||
| <p>OpenShift enforces Security Constraints Context (scc) when deploying an image. | ||||
| By default, container images run in restricted scc which prevents from setting | ||||
| a fixed user id to run with. You need to have ensure that you do not provide a | ||||
| securityContext with a runAsUser and that your image does not use a hardcoded user.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">securityContext<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>{}</code></pre></div> | ||||
| <h2 id="openshift-jenkins-image">OpenShift Jenkins image</h2> | ||||
| 
 | ||||
| <p>OpenShift provides a pre-configured Jenkins image containing  3 openshift plugins for | ||||
| jenkins (openshift-login-plugin, openshift-sync-plugin and openshift-client-plugin) | ||||
| which allows better jenkins integration with kubernetes and OpenShift.</p> | ||||
| 
 | ||||
| <p>The OpenShift Jenkins image requires additional configuration to be fully enabled.</p> | ||||
| 
 | ||||
| <h3 id="sample-openshift-cr">Sample OpenShift CR</h3> | ||||
| 
 | ||||
| <p>The following Custom Resource can be used to create a Jenkins instance using the<br /> | ||||
| OpenShift Jenkins image and sets values for: | ||||
| - `image: &lsquo;quay.io/openshift/origin-jenkins:latest&rsquo; : This is the OpenShift Jenkins image.</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p>serviceAccount: to allow oauth authentication to work, the service account needs | ||||
| a specific annotation pointing to the route exposing the jenkins service. Here, | ||||
| the route is named <code>jenkins-route</code></p></li> | ||||
| 
 | ||||
| <li><p><code>OPENSHIFT_ENABLE_OAUTH</code> environment variable for the master container is set to true.</p></li> | ||||
| </ul> | ||||
| 
 | ||||
| <p>Here is a complete Jenkins CR allowing the deployment of the Jenkins OpenShift image.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>jenkins.io/openshift-mode<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>serviceAccount<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>serviceaccounts.openshift.io/oauth-redirectreference.jenkins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;{&#34;kind&#34;:&#34;OAuthRedirectReference&#34;,&#34;apiVersion&#34;:&#34;v1&#34;,&#34;reference&#34;:{&#34;kind&#34;:&#34;Route&#34;,&#34;name&#34;:&#34;jenkins-route&#34;}}&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>containers<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-master<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>image<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;quay.io/openshift/origin-jenkins:latest&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>command<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/bin/go-init<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;-main&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/libexec/s2i/run<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>env<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_OAUTH<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_REDIRECT_PROMPT<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>DISABLE_ADMINISTRATIVE_MONITORS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;false&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_MASTER<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;https://kubernetes.default:443&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_TRUST_CERTIFICATES<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-http-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JNLP_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-slave-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_UC_INSECURE<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;false&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_HOME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>/var/lib/jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JAVA_OPTS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>&gt;<span style="color:#8f5902;font-style:italic">- | ||||
| </span><span style="color:#8f5902;font-style:italic">          -XX:+UnlockExperimentalVMOptions -XX:+UnlockExperimentalVMOptions</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-XX<span style="color:#000;font-weight:bold">:</span>+UseCGroupMemoryLimitForHeap<span style="color:#f8f8f8;text-decoration:underline"> </span>-XX<span style="color:#000;font-weight:bold">:</span>MaxRAMFraction=<span style="color:#0000cf;font-weight:bold">1</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-Djenkins.install.runSetupWizard=<span style="color:#204a87;font-weight:bold">false</span><span style="color:#f8f8f8;text-decoration:underline"> </span>-Djava.awt.headless=<span style="color:#204a87;font-weight:bold">true</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>imagePullPolicy<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Always<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>service<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">8080</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>slaveService<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">50000</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP</code></pre></div> | ||||
| <h3 id="openshift-oauth-integration">OpenShift OAuth integration</h3> | ||||
| 
 | ||||
| <p>The creation of a Route is required for the integraiton of Jenkins with | ||||
| OpenShift oauth authentication. By default, the jenkins http service is named | ||||
| <code>jenkins-operator-http-${jenkins-cr-name}</code></p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">oc create route edge jenkins-route --service<span style="color:#ce5c00;font-weight:bold">=</span>jenkins-operator-http-jenkins</code></pre></div> | ||||
| <p>Note: the route name (jenkins-route) must match the pointed route on the serviceaccount annotation.</p> | ||||
| 
 | ||||
| <p>After the creation of the Route. It can be used to navigate to the Jenkins Login Page and login with your Openshift Credentials.</p> | ||||
| 
 | ||||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|     <item> | ||||
|       <title>Docs: Diagnostics</title> | ||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/diagnostics/</link> | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -0,0 +1,806 @@ | |||
| <!doctype html> | ||||
| <html lang="en" class="no-js"> | ||||
|   <head> | ||||
|     <meta charset="utf-8"> | ||||
| <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> | ||||
| <meta name="generator" content="Hugo 0.57.2" /> | ||||
| 
 | ||||
| <META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW"> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <link rel="shortcut icon" href="/favicons/favicon.ico" > | ||||
| <link rel="apple-touch-icon" href="/kubernetes-operator/favicons/apple-touch-icon-180x180.png" sizes="180x180"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/favicon-16x16.png" sizes="16x16"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/favicon-32x32.png" sizes="32x32"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-36x36.png" sizes="36x36"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-48x48.png" sizes="48x48"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-72x72.png" sizes="72x72"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-96x196.png" sizes="96x196"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-144x144.png" sizes="144x144"> | ||||
| <link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-192x192.png"sizes="192x192"> | ||||
| 
 | ||||
| <title>OpenShift | Jenkins Operator</title><meta property="og:title" content="OpenShift" /> | ||||
| <meta property="og:description" content="Additional configuration for OpenShift | ||||
| " /> | ||||
| <meta property="og:type" content="article" /> | ||||
| <meta property="og:url" content="https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/" /> | ||||
| <meta property="article:published_time" content="2020-04-29T00:00:00+00:00" /> | ||||
| <meta property="article:modified_time" content="2020-04-29T00:00:00+00:00" /><meta property="og:site_name" content="Jenkins Operator" /> | ||||
| <meta itemprop="name" content="OpenShift"> | ||||
| <meta itemprop="description" content="Additional configuration for OpenShift | ||||
| "> | ||||
| 
 | ||||
| 
 | ||||
| <meta itemprop="datePublished" content="2020-04-29T00:00:00+00:00" /> | ||||
| <meta itemprop="dateModified" content="2020-04-29T00:00:00+00:00" /> | ||||
| <meta itemprop="wordCount" content="256"> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <meta itemprop="keywords" content="" /> | ||||
| <meta name="twitter:card" content="summary"/> | ||||
| <meta name="twitter:title" content="OpenShift"/> | ||||
| <meta name="twitter:description" content="Additional configuration for OpenShift | ||||
| "/> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <link rel="preload" href="/kubernetes-operator/scss/main.min.76f9ae686f932b9aa67346ef8543e8a6b0302cb67aa119d21b053c31bc3f2448.css" as="style"> | ||||
| <link href="/kubernetes-operator/scss/main.min.76f9ae686f932b9aa67346ef8543e8a6b0302cb67aa119d21b053c31bc3f2448.css" rel="stylesheet" integrity=""> | ||||
| 
 | ||||
| <script | ||||
|   src="https://code.jquery.com/jquery-3.3.1.min.js" | ||||
|   integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=" | ||||
|   crossorigin="anonymous"></script> | ||||
| 
 | ||||
| 
 | ||||
|     <title>OpenShift | Jenkins Operator</title> | ||||
|   </head> | ||||
|   <body class="td-page"> | ||||
|     <header> | ||||
|        | ||||
| <nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar"> | ||||
| 	<a class="navbar-brand" href="/kubernetes-operator/"> | ||||
| 		<img style="width: 32px; height: 32px; margin-right: 7.5px;" src="/kubernetes-operator/img/logo.svg"></img><span class="text-uppercase font-weight-bold">Jenkins Operator</span> | ||||
| 	</a> | ||||
| 	<div class="td-navbar-nav-scroll ml-md-auto" id="main_navbar"> | ||||
| 		<ul class="navbar-nav mt-2 mt-lg-0"> | ||||
| 			<li class="nav-item mr-4 mb-2 mb-lg-0"> | ||||
| 				<a class="nav-link" href="/kubernetes-operator/about"><span>What's the Jenkins Operator?</span></a> | ||||
|             </li> | ||||
|             <li class="nav-item mr-4 mb-2 mb-lg-0"> | ||||
|                 <a class="nav-link" href="/kubernetes-operator/docs"><span>Documentation</span></a> | ||||
|             </li> | ||||
| 			 | ||||
| 		</ul> | ||||
| 	</div> | ||||
| 	<div class="navbar-nav d-none d-lg-block"> | ||||
|  <input type="search" class="form-control td-search-input" placeholder=" Search this site…" aria-label="Search this site…" autocomplete="off"> | ||||
| </div> | ||||
| </nav> | ||||
| 
 | ||||
|     </header> | ||||
|     <div class="container-fluid td-outer"> | ||||
|       <div class="td-main"> | ||||
|         <div class="row flex-xl-nowrap"> | ||||
|           <div class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none"> | ||||
|              | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <div id="td-sidebar-menu" class="td-sidebar__inner"> | ||||
|    | ||||
|   <form class="td-sidebar__search d-flex align-items-center"> | ||||
|      | ||||
|  <input type="search" class="form-control td-search-input" placeholder=" Search this site…" aria-label="Search this site…" autocomplete="off"> | ||||
| 
 | ||||
|     <button class="btn btn-link td-sidebar__toggle d-md-none p-0 ml-3 fas fa-bars" type="button" data-toggle="collapse" data-target="#td-section-nav" aria-controls="td-docs-nav" aria-expanded="false" aria-label="Toggle section navigation"> | ||||
|     </button> | ||||
|   </form> | ||||
|    | ||||
|   <nav class="collapse td-sidebar-nav pt-2 pl-4" id="td-section-nav"> | ||||
|      | ||||
|      | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Documentation</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse show" id="kubernetes-operator-docs"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/installation/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Installation</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-installation"> | ||||
|        | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/how-it-works/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">How it works</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-how-it-works"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-how-it-works-architecture-and-design" href="/kubernetes-operator/docs/how-it-works/architecture-and-design/">Architecture and design</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-how-it-works-jenkins-docker-images" href="/kubernetes-operator/docs/how-it-works/jenkins-docker-images/">Jenkins Docker Images</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/getting-started/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Getting Started</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse show" id="kubernetes-operator-docs-getting-started"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/getting-started/latest/" class="align-left pl-0 pr-2 active td-sidebar-link td-sidebar-link__section">Latest (v0.4.x)</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse show" id="kubernetes-operator-docs-getting-started-latest"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/latest/deploy-jenkins/">Deploy Jenkins</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-configuration" href="/kubernetes-operator/docs/getting-started/latest/configuration/">Configuration</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-customization" href="/kubernetes-operator/docs/getting-started/latest/customization/">Customization</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-aks" href="/kubernetes-operator/docs/getting-started/latest/aks/">AKS</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/latest/configure-backup-and-restore/">Configure backup and restore</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/latest/custom-backup-and-restore/">Custom Backup and Restore Providers</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-notifications" href="/kubernetes-operator/docs/getting-started/latest/notifications/">Notifications</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page  active" id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-schema" href="/kubernetes-operator/docs/getting-started/latest/schema/">Schema</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/getting-started/v0.3.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.3.x</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-getting-started-v0-3-x"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.3.x/deploy-jenkins/">Deploy Jenkins</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.3.x/configuration/">Configuration</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-customization" href="/kubernetes-operator/docs/getting-started/v0.3.x/customization/">Customization</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-migration" href="/kubernetes-operator/docs/getting-started/v0.3.x/migration/">Migration from v0.2.x</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-aks" href="/kubernetes-operator/docs/getting-started/v0.3.x/aks/">AKS</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.3.x/configure-backup-and-restore/">Configure backup and restore</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.3.x/custom-backup-and-restore/">Custom Backup and Restore Providers</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-notifications" href="/kubernetes-operator/docs/getting-started/v0.3.x/notifications/">Notifications</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.3.x/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-schema" href="/kubernetes-operator/docs/getting-started/v0.3.x/schema/">Schema</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/getting-started/v0.1.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.1.x</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-getting-started-v0-1-x"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.1.x/deploy-jenkins/">Deploy Jenkins</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.1.x/configuration/">Configuration</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-customization" href="/kubernetes-operator/docs/getting-started/v0.1.x/customization/">Customization</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-aks" href="/kubernetes-operator/docs/getting-started/v0.1.x/aks/">AKS</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.1.x/configure-backup-and-restore/">Configure backup and restore</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.1.x/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-scheme" href="/kubernetes-operator/docs/getting-started/v0.1.x/scheme/">Scheme</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-migration-guide-v1alpha1-to-v1alpha2" href="/kubernetes-operator/docs/getting-started/v0.1.x/migration-guide-v1alpha1-to-v1alpha2/">Migration guide from v1alpha1 to v1alpha2</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/getting-started/v0.2.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.2.x</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-getting-started-v0-2-x"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.2.x/deploy-jenkins/">Deploy Jenkins</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.2.x/configuration/">Configuration</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-customization" href="/kubernetes-operator/docs/getting-started/v0.2.x/customization/">Customization</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-aks" href="/kubernetes-operator/docs/getting-started/v0.2.x/aks/">AKS</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.2.x/configure-backup-and-restore/">Configure backup and restore</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.2.x/custom-backup-and-restore/">Custom Backup and Restore Providers</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-migration" href="/kubernetes-operator/docs/getting-started/v0.2.x/migration/">Migration from v0.1.x</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.2.x/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-schema" href="/kubernetes-operator/docs/getting-started/v0.2.x/schema/">Schema</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/security/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Security</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-security"> | ||||
|        | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <ul class="td-sidebar-nav__section pr-md-3"> | ||||
|   <li class="td-sidebar-nav__section-title"> | ||||
|     <a  href="/kubernetes-operator/docs/developer-guide/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Developer Guide</a> | ||||
|   </li> | ||||
|   <ul> | ||||
|     <li class="collapse " id="kubernetes-operator-docs-developer-guide"> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-developer-guide-tools" href="/kubernetes-operator/docs/developer-guide/tools/">Tools</a> | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|        | ||||
|        | ||||
|     </li> | ||||
|   </ul> | ||||
| </ul> | ||||
| 
 | ||||
|   </nav> | ||||
| </div> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|           </div> | ||||
|           <div class="d-none d-xl-block col-xl-2 td-toc d-print-none"> | ||||
|              | ||||
|      | ||||
|      | ||||
|      | ||||
|       <div class="td-page-meta ml-2 pb-1 pt-2 mb-0"> | ||||
|            | ||||
|            | ||||
|            | ||||
|         <a href="https://github.com/jenkinsci/kubernetes-operator/edit/master/website/content/en/docs/Getting%20Started/latest/openshift.md" target="_blank"><i class="fa fa-edit fa-fw"></i> Edit this page</a> | ||||
|         <a href="https://github.com/jenkinsci/kubernetes-operator/issues/new?title=OpenShift" target="_blank"><i class="fab fa-github fa-fw"></i> Create documentation issue</a> | ||||
|            | ||||
|                | ||||
|               <a href="https://github.com/jenkinsci/kubernetes-operator/issues/new" target="_blank"><i class="fas fa-tasks fa-fw"></i> Create project issue</a> | ||||
|            | ||||
|       </div> | ||||
|      | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <nav id="TableOfContents"> | ||||
| <ul> | ||||
| <li> | ||||
| <ul> | ||||
| <li><a href="#securitycontext">SecurityContext</a></li> | ||||
| <li><a href="#openshift-jenkins-image">OpenShift Jenkins image</a> | ||||
| <ul> | ||||
| <li><a href="#sample-openshift-cr">Sample OpenShift CR</a></li> | ||||
| <li><a href="#openshift-oauth-integration">OpenShift OAuth integration</a></li> | ||||
| </ul></li> | ||||
| </ul></li> | ||||
| </ul> | ||||
| </nav> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|           </div> | ||||
|           <main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main"> | ||||
|             <nav aria-label="breadcrumb" class="d-none d-md-block d-print-none"> | ||||
| 	<ol class="breadcrumb spb-1"> | ||||
| 		 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <li class="breadcrumb-item" > | ||||
| 	<a href="https://jenkinsci.github.io/kubernetes-operator/docs/">Documentation</a> | ||||
| </li> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <li class="breadcrumb-item" > | ||||
| 	<a href="https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/">Getting Started</a> | ||||
| </li> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <li class="breadcrumb-item" > | ||||
| 	<a href="https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/">Latest (v0.4.x)</a> | ||||
| </li> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <li class="breadcrumb-item active" aria-current="page"> | ||||
| 	<a href="https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
| </li> | ||||
| 
 | ||||
| 	</ol> | ||||
| </nav	> | ||||
| 
 | ||||
|              | ||||
| <div class="td-content"> | ||||
| 	<h1>OpenShift</h1> | ||||
| 	<div class="lead">Additional configuration for OpenShift</div> | ||||
| 	 | ||||
| 
 | ||||
| <h2 id="securitycontext">SecurityContext</h2> | ||||
| 
 | ||||
| <p>OpenShift enforces Security Constraints Context (scc) when deploying an image. | ||||
| By default, container images run in restricted scc which prevents from setting | ||||
| a fixed user id to run with. You need to have ensure that you do not provide a | ||||
| securityContext with a runAsUser and that your image does not use a hardcoded user.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">securityContext<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>{}</code></pre></div> | ||||
| <h2 id="openshift-jenkins-image">OpenShift Jenkins image</h2> | ||||
| 
 | ||||
| <p>OpenShift provides a pre-configured Jenkins image containing  3 openshift plugins for | ||||
| jenkins (openshift-login-plugin, openshift-sync-plugin and openshift-client-plugin) | ||||
| which allows better jenkins integration with kubernetes and OpenShift.</p> | ||||
| 
 | ||||
| <p>The OpenShift Jenkins image requires additional configuration to be fully enabled.</p> | ||||
| 
 | ||||
| <h3 id="sample-openshift-cr">Sample OpenShift CR</h3> | ||||
| 
 | ||||
| <p>The following Custom Resource can be used to create a Jenkins instance using the<br /> | ||||
| OpenShift Jenkins image and sets values for: | ||||
| - `image: ‘quay.io/openshift/origin-jenkins:latest’ : This is the OpenShift Jenkins image.</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p>serviceAccount: to allow oauth authentication to work, the service account needs | ||||
| a specific annotation pointing to the route exposing the jenkins service. Here, | ||||
| the route is named <code>jenkins-route</code></p></li> | ||||
| 
 | ||||
| <li><p><code>OPENSHIFT_ENABLE_OAUTH</code> environment variable for the master container is set to true.</p></li> | ||||
| </ul> | ||||
| 
 | ||||
| <p>Here is a complete Jenkins CR allowing the deployment of the Jenkins OpenShift image.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>jenkins.io/openshift-mode<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'true'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>serviceAccount<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>serviceaccounts.openshift.io/oauth-redirectreference.jenkins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'{"kind":"OAuthRedirectReference","apiVersion":"v1","reference":{"kind":"Route","name":"jenkins-route"}}'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>containers<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-master<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>image<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'quay.io/openshift/origin-jenkins:latest'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>command<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/bin/go-init<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'-main'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/libexec/s2i/run<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>env<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_OAUTH<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'true'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_REDIRECT_PROMPT<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'true'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>DISABLE_ADMINISTRATIVE_MONITORS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'false'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_MASTER<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'https://kubernetes.default:443'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_TRUST_CERTIFICATES<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'true'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-http-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JNLP_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-slave-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_UC_INSECURE<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">'false'</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_HOME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>/var/lib/jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JAVA_OPTS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>><span style="color:#8f5902;font-style:italic">- | ||||
| </span><span style="color:#8f5902;font-style:italic">          -XX:+UnlockExperimentalVMOptions -XX:+UnlockExperimentalVMOptions</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-XX<span style="color:#000;font-weight:bold">:</span>+UseCGroupMemoryLimitForHeap<span style="color:#f8f8f8;text-decoration:underline"> </span>-XX<span style="color:#000;font-weight:bold">:</span>MaxRAMFraction=<span style="color:#0000cf;font-weight:bold">1</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-Djenkins.install.runSetupWizard=<span style="color:#204a87;font-weight:bold">false</span><span style="color:#f8f8f8;text-decoration:underline"> </span>-Djava.awt.headless=<span style="color:#204a87;font-weight:bold">true</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>imagePullPolicy<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Always<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>service<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">8080</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>slaveService<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">50000</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP</code></pre></div> | ||||
| <h3 id="openshift-oauth-integration">OpenShift OAuth integration</h3> | ||||
| 
 | ||||
| <p>The creation of a Route is required for the integraiton of Jenkins with | ||||
| OpenShift oauth authentication. By default, the jenkins http service is named | ||||
| <code>jenkins-operator-http-${jenkins-cr-name}</code></p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">oc create route edge jenkins-route --service<span style="color:#ce5c00;font-weight:bold">=</span>jenkins-operator-http-jenkins</code></pre></div> | ||||
| <p>Note: the route name (jenkins-route) must match the pointed route on the serviceaccount annotation.</p> | ||||
| 
 | ||||
| <p>After the creation of the Route. It can be used to navigate to the Jenkins Login Page and login with your Openshift Credentials.</p> | ||||
| 
 | ||||
| 	 | ||||
| 	 | ||||
| 	<div class="text-muted mt-5 pt-3 border-top">Last modified April 29, 2020 | ||||
| </div> | ||||
| </div> | ||||
| 
 | ||||
| 
 | ||||
|           </main> | ||||
|         </div> | ||||
|       </div> | ||||
|        | ||||
| <footer class="bg-dark py-5 row d-print-none"> | ||||
|   <div class="container-fluid mx-sm-5"> | ||||
|     <div class="row"> | ||||
|       <div class="col-6 col-sm-4 text-xs-center order-sm-2"> | ||||
|          | ||||
|       </div> | ||||
|       <div class="col-6 col-sm-4 text-right text-xs-center order-sm-3"> | ||||
|          | ||||
|       </div> | ||||
|       <div class="col-12 col-sm-4 text-center py-2 order-sm-2"> | ||||
|         <small class="text-white">© 2020 VirtusLab All Rights Reserved</small> | ||||
|          | ||||
| 	 | ||||
| 		<p class="mt-2"><a href="/kubernetes-operator/about/">What's the Jenkins Operator?</a></p> | ||||
| 	 | ||||
|       </div> | ||||
|     </div> | ||||
|   </div> | ||||
| </footer> | ||||
| 
 | ||||
| 
 | ||||
|     </div> | ||||
|      | ||||
| <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js" integrity="sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49" crossorigin="anonymous"></script> | ||||
| <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js" integrity="sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy" crossorigin="anonymous"></script> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| <script src="/kubernetes-operator/js/main.min.b0e99aac17991fa76812dd47914049168ac469a1faa0939560f0b370565becab.js" integrity="sha256-sOmarBeZH6doEt1HkUBJForEaaH6oJOVYPCzcFZb7Ks="></script> | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|   </body> | ||||
| </html> | ||||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -774,6 +780,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -792,6 +798,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -794,6 +800,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -744,6 +750,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|      | ||||
|  |  | |||
|  | @ -257,6 +257,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  |  | |||
|  | @ -247,6 +247,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -735,6 +741,8 @@ | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|  |  | |||
|  | @ -573,6 +573,10 @@ stringData: | |||
|   password: password_or_token | ||||
| </code></pre> | ||||
| 
 | ||||
| <h3 id="external-authentication">External authentication</h3> | ||||
| 
 | ||||
| <p>You can use <code>external</code> credential type if you want to configure authentication using Configuration As Code or Groovy Script.</p> | ||||
| 
 | ||||
| <h2 id="http-proxy-for-downloading-plugins">HTTP Proxy for downloading plugins</h2> | ||||
| 
 | ||||
| <p>To use forwarding proxy with an operator to download plugins you need to add the following environment variable to Jenkins Custom Resource (CR), e.g.:</p> | ||||
|  | @ -1536,11 +1540,72 @@ stringData: | |||
|          | ||||
|          | ||||
| 
 | ||||
| <p>Jenkins can be customized using groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||
| 
 | ||||
| <p>Jenkins can be customized with plugins. | ||||
| Plugin&rsquo;s configuration is applied as groovy scripts or the <a href="https://github.com/jenkinsci/configuration-as-code-plugin" target="_blank">configuration as code plugin</a>. | ||||
| Any plugin working for Jenkins can be installed by the Jenkins Operator.</p> | ||||
| 
 | ||||
| <p>Pre-installed plugins: | ||||
| * configuration-as-code v1.38 | ||||
| * git v4.2.2 | ||||
| * job-dsl v1.77 | ||||
| * kubernetes-credentials-provider v0.13 | ||||
| * kubernetes v1.25.2 | ||||
| * workflow-aggregator v2.6 | ||||
| * workflow-job v2.38</p> | ||||
| 
 | ||||
| <p>Rest of the plugins can be found in <a href="https://plugins.jenkins.io/" target="_blank">plugins repository</a>.</p> | ||||
| 
 | ||||
| <h4 id="install-plugins">Install plugins</h4> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.34&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.6&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.76&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.29&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.19&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restart.</p> | ||||
| 
 | ||||
| <h4 id="apply-plugin-s-config">Apply plugin&rsquo;s config</h4> | ||||
| 
 | ||||
| <p>By using a <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/" target="_blank">ConfigMap</a> you can create your own <strong>Jenkins</strong> customized configuration. | ||||
| Then you must reference the <strong><code>ConfigMap</code></strong> in the <strong>Jenkins</strong> pod customization file in <code>spec.groovyScripts</code> or <code>spec.configurationAsCode</code></p> | ||||
| 
 | ||||
| <p>For example create a <strong><code>ConfigMap</code></strong> with name <code>jenkins-operator-user-configuration</code>. Then, modify the <strong>Jenkins</strong> manifest to look like this:</p> | ||||
| <p>Create a <strong><code>ConfigMap</code></strong> with specific name (eg. <code>jenkins-operator-user-configuration</code>). Then, modify the <strong>Jenkins</strong> manifest:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
|  | @ -1589,7 +1654,7 @@ Then you must reference the <strong><code>ConfigMap</code>< | |||
| <p>If you want to correct your configuration you can edit it while the <strong>Jenkins Operator</strong> is running. | ||||
| Jenkins will reconcile and apply the new configuration.</p> | ||||
| 
 | ||||
| <h3 id="using-secrets-from-a-groovy-script">Using secrets from a Groovy script</h3> | ||||
| <h2 id="how-to-use-secrets-from-a-groovy-scripts">How to use secrets from a Groovy scripts</h2> | ||||
| 
 | ||||
| <p>If you configured <code>spec.groovyScripts.secret.name</code>, then this secret is available to use from map Groovy scripts. | ||||
| The secrets are loaded to <code>secrets</code> map.</p> | ||||
|  | @ -1645,49 +1710,6 @@ The secrets are loaded to <code>secrets</code> map.</p> | |||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>systemMessage<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>${SYSTEM_MESSAGE}</code></pre></div> | ||||
| <p>After this, you should see the <code>Hello world</code> system message from the <strong>Jenkins</strong> homepage.</p> | ||||
| 
 | ||||
| <h2 id="install-plugins">Install Plugins</h2> | ||||
| 
 | ||||
| <p>Edit Custom Resource under <code>spec.master.plugins</code>:</p> | ||||
| 
 | ||||
| <pre><code>apiVersion: jenkins.io/v1alpha2 | ||||
| kind: Jenkins | ||||
| metadata: | ||||
|   name: example | ||||
| spec: | ||||
|   master: | ||||
|    plugins: | ||||
|    - name: simple-theme-plugin | ||||
|      version: 0.5.1 | ||||
| </code></pre> | ||||
| 
 | ||||
| <p>Under <code>spec.master.basePlugins</code> you can find plugins for a valid <strong>Jenkins Operator</strong>:</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>basePlugins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">1.18.3</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-job<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.34&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>workflow-aggregator<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;2.6&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>git<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">3.12.0</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>job-dsl<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.76&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.29&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>configuration-as-code-support<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;1.19&#34;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>kubernetes-credentials-provider<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>version<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">0.12.1</span></code></pre></div> | ||||
| <p>You can change their versions.</p> | ||||
| 
 | ||||
| <p>The <strong>Jenkins Operator</strong> will then automatically install plugins after the Jenkins master pod restarts.</p> | ||||
| 
 | ||||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|  | @ -2448,7 +2470,7 @@ the number of backups under control, e.g. Cloud Formation fragment:</p> | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       slack: | ||||
|  | @ -2468,7 +2490,7 @@ spec: | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       teams: | ||||
|  | @ -2486,7 +2508,7 @@ spec: | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: &lt;name&gt; | ||||
|       mailgun: | ||||
|  | @ -2504,7 +2526,7 @@ spec: | |||
| <p>As you see there is two debugging options:</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p><code>loggingLevel</code> (warning/info) - Set level of messages to send.</p></li> | ||||
| <li><p><code>level</code> (warning/info) - Set level of messages to send.</p></li> | ||||
| 
 | ||||
| <li><p><code>verbose</code> - Print stacktrace and additional error messages</p></li> | ||||
| </ul> | ||||
|  | @ -2518,7 +2540,7 @@ For example you will send notifications to Slack and Teams.</p> | |||
| spec: | ||||
|   master: | ||||
|     notifications: | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: nslack | ||||
|       slack: | ||||
|  | @ -2526,7 +2548,7 @@ spec: | |||
|           secret: | ||||
|             name: &lt;secret_name&gt; | ||||
|           key: &lt;key&gt; | ||||
|     - loggingLevel: info | ||||
|     - level: info | ||||
|       verbose: true | ||||
|       name: nteams | ||||
|       teams: | ||||
|  | @ -3450,6 +3472,109 @@ and add explicit references to the existing <code>ConfigMap</code> a | |||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|     <item> | ||||
|       <title>Docs: OpenShift</title> | ||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/</link> | ||||
|       <pubDate>Wed, 29 Apr 2020 00:00:00 +0000</pubDate> | ||||
|        | ||||
|       <guid>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/</guid> | ||||
|       <description> | ||||
|          | ||||
|          | ||||
|          | ||||
| 
 | ||||
| <h2 id="securitycontext">SecurityContext</h2> | ||||
| 
 | ||||
| <p>OpenShift enforces Security Constraints Context (scc) when deploying an image. | ||||
| By default, container images run in restricted scc which prevents from setting | ||||
| a fixed user id to run with. You need to have ensure that you do not provide a | ||||
| securityContext with a runAsUser and that your image does not use a hardcoded user.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">securityContext<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>{}</code></pre></div> | ||||
| <h2 id="openshift-jenkins-image">OpenShift Jenkins image</h2> | ||||
| 
 | ||||
| <p>OpenShift provides a pre-configured Jenkins image containing  3 openshift plugins for | ||||
| jenkins (openshift-login-plugin, openshift-sync-plugin and openshift-client-plugin) | ||||
| which allows better jenkins integration with kubernetes and OpenShift.</p> | ||||
| 
 | ||||
| <p>The OpenShift Jenkins image requires additional configuration to be fully enabled.</p> | ||||
| 
 | ||||
| <h3 id="sample-openshift-cr">Sample OpenShift CR</h3> | ||||
| 
 | ||||
| <p>The following Custom Resource can be used to create a Jenkins instance using the<br /> | ||||
| OpenShift Jenkins image and sets values for: | ||||
| - `image: &lsquo;quay.io/openshift/origin-jenkins:latest&rsquo; : This is the OpenShift Jenkins image.</p> | ||||
| 
 | ||||
| <ul> | ||||
| <li><p>serviceAccount: to allow oauth authentication to work, the service account needs | ||||
| a specific annotation pointing to the route exposing the jenkins service. Here, | ||||
| the route is named <code>jenkins-route</code></p></li> | ||||
| 
 | ||||
| <li><p><code>OPENSHIFT_ENABLE_OAUTH</code> environment variable for the master container is set to true.</p></li> | ||||
| </ul> | ||||
| 
 | ||||
| <p>Here is a complete Jenkins CR allowing the deployment of the Jenkins OpenShift image.</p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml">apiVersion<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins.io/v1alpha2<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>kind<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>metadata<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>jenkins.io/openshift-mode<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline"></span>spec<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>serviceAccount<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>annotations<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>serviceaccounts.openshift.io/oauth-redirectreference.jenkins<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;{&#34;kind&#34;:&#34;OAuthRedirectReference&#34;,&#34;apiVersion&#34;:&#34;v1&#34;,&#34;reference&#34;:{&#34;kind&#34;:&#34;Route&#34;,&#34;name&#34;:&#34;jenkins-route&#34;}}&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>master<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>containers<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-master<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>image<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;quay.io/openshift/origin-jenkins:latest&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>command<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/bin/go-init<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;-main&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>/usr/libexec/s2i/run<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>env<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_OAUTH<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>OPENSHIFT_ENABLE_REDIRECT_PROMPT<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>DISABLE_ADMINISTRATIVE_MONITORS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;false&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_MASTER<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;https://kubernetes.default:443&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>KUBERNETES_TRUST_CERTIFICATES<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;true&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-http-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JNLP_SERVICE_NAME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>jenkins-operator-slave-jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_UC_INSECURE<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#39;false&#39;</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JENKINS_HOME<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>/var/lib/jenkins<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>-<span style="color:#f8f8f8;text-decoration:underline"> </span>name<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>JAVA_OPTS<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">        </span>value<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>&gt;<span style="color:#8f5902;font-style:italic">- | ||||
| </span><span style="color:#8f5902;font-style:italic">          -XX:+UnlockExperimentalVMOptions -XX:+UnlockExperimentalVMOptions</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-XX<span style="color:#000;font-weight:bold">:</span>+UseCGroupMemoryLimitForHeap<span style="color:#f8f8f8;text-decoration:underline"> </span>-XX<span style="color:#000;font-weight:bold">:</span>MaxRAMFraction=<span style="color:#0000cf;font-weight:bold">1</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">          </span>-Djenkins.install.runSetupWizard=<span style="color:#204a87;font-weight:bold">false</span><span style="color:#f8f8f8;text-decoration:underline"> </span>-Djava.awt.headless=<span style="color:#204a87;font-weight:bold">true</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">      </span>imagePullPolicy<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Always<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>service<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">8080</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP<span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">  </span>slaveService<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>port<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#0000cf;font-weight:bold">50000</span><span style="color:#f8f8f8;text-decoration:underline"> | ||||
| </span><span style="color:#f8f8f8;text-decoration:underline">    </span>type<span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>ClusterIP</code></pre></div> | ||||
| <h3 id="openshift-oauth-integration">OpenShift OAuth integration</h3> | ||||
| 
 | ||||
| <p>The creation of a Route is required for the integraiton of Jenkins with | ||||
| OpenShift oauth authentication. By default, the jenkins http service is named | ||||
| <code>jenkins-operator-http-${jenkins-cr-name}</code></p> | ||||
| <div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">oc create route edge jenkins-route --service<span style="color:#ce5c00;font-weight:bold">=</span>jenkins-operator-http-jenkins</code></pre></div> | ||||
| <p>Note: the route name (jenkins-route) must match the pointed route on the serviceaccount annotation.</p> | ||||
| 
 | ||||
| <p>After the creation of the Route. It can be used to navigate to the Jenkins Login Page and login with your Openshift Credentials.</p> | ||||
| 
 | ||||
|       </description> | ||||
|     </item> | ||||
|      | ||||
|     <item> | ||||
|       <title>Docs: Tools</title> | ||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/tools/</link> | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -781,6 +787,8 @@ $ helm install jenkins/jenkins-operator</code></pre></div> | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|      | ||||
|  |  | |||
|  | @ -250,6 +250,12 @@ | |||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a> | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|        | ||||
|       <a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a> | ||||
|        | ||||
|        | ||||
|  | @ -823,6 +829,8 @@ $ kubectl -n jenkins apply -f role_binding_jenkins.yaml</code></pre></div> | |||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|              | ||||
|          | ||||
|      | ||||
|  |  | |||
|  | @ -26,7 +26,7 @@ | |||
| <meta property="og:type" content="website" /> | ||||
| <meta property="og:url" content="https://jenkinsci.github.io/kubernetes-operator/" /> | ||||
| 
 | ||||
| <meta property="og:updated_time" content="2020-04-13T00:00:00+00:00" /><meta property="og:site_name" content="Jenkins Operator" /> | ||||
| <meta property="og:updated_time" content="2020-04-29T00:00:00+00:00" /><meta property="og:site_name" content="Jenkins Operator" /> | ||||
| <meta itemprop="name" content="Jenkins Kubernetes Operator"> | ||||
| <meta itemprop="description" content="A native operator for Kubernetes to manage Jenkins"> | ||||
| 
 | ||||
|  |  | |||
|  | @ -4,7 +4,7 @@ | |||
|     <link>https://jenkinsci.github.io/kubernetes-operator/</link> | ||||
|     <description>Recent Hugo news from gohugo.io</description> | ||||
|     <generator>Hugo -- gohugo.io</generator> | ||||
|     <lastBuildDate>Mon, 13 Apr 2020 00:00:00 +0000</lastBuildDate> | ||||
|     <lastBuildDate>Wed, 29 Apr 2020 00:00:00 +0000</lastBuildDate> | ||||
|     <image> | ||||
|       <url>https://jenkinsci.github.io/kubernetes-operator/img/hugo.png</url> | ||||
|       <title>GoHugo.io</title> | ||||
|  |  | |||
|  | @ -182,6 +182,11 @@ | |||
|     <lastmod>2019-08-05T00:00:00+00:00</lastmod> | ||||
|   </url> | ||||
|    | ||||
|   <url> | ||||
|     <loc>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/openshift/</loc> | ||||
|     <lastmod>2020-04-29T00:00:00+00:00</lastmod> | ||||
|   </url> | ||||
|    | ||||
|   <url> | ||||
|     <loc>https://jenkinsci.github.io/kubernetes-operator/docs/</loc> | ||||
|     <lastmod>2019-09-03T00:00:00+00:00</lastmod> | ||||
|  | @ -259,7 +264,7 @@ | |||
|    | ||||
|   <url> | ||||
|     <loc>https://jenkinsci.github.io/kubernetes-operator/</loc> | ||||
|     <lastmod>2020-04-13T00:00:00+00:00</lastmod> | ||||
|     <lastmod>2020-04-29T00:00:00+00:00</lastmod> | ||||
|   </url> | ||||
|    | ||||
|   <url> | ||||
|  |  | |||
		Loading…
	
		Reference in New Issue