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> |       <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> | <ul> | ||||||
| <li><a href="#prerequisites">Prerequisites</a></li> | <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="#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="#build-and-run-with-a-remote-kubernetes-cluster">Build and run with a remote Kubernetes cluster</a></li> | ||||||
| <li><a href="#testing">Testing</a> | <li><a href="#testing">Testing</a> | ||||||
| <ul> | <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="#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> | <li><a href="#getting-the-jenkins-url-and-basic-credentials">Getting the Jenkins URL and basic credentials</a></li> | ||||||
| </ul></li> | </ul></li> | ||||||
|  | <li><a href="#self-learning">Self-learning</a></li> | ||||||
| </ul></li> | </ul></li> | ||||||
| </ul> | </ul> | ||||||
| </nav> | </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> | <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> | <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> | <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 | ||||||
| <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 | 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>  | ||||||
| kubectl get jenkins -o yaml | 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.                     | ||||||
| kubectl get po</code></pre></div> | <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> | <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> | <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 | <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.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> | 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"> |         <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> |       <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> |       <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> |       <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="datePublished" content="2020-04-13T00:00:00+00:00" /> | ||||||
| <meta itemprop="dateModified" 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> |       <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> | <li><a href="#configure-ssh-authentication">Configure SSH authentication</a></li> | ||||||
| </ul></li> | </ul></li> | ||||||
| <li><a href="#username-password-authentication">Username & password authentication</a></li> | <li><a href="#username-password-authentication">Username & password authentication</a></li> | ||||||
|  | <li><a href="#external-authentication">External authentication</a></li> | ||||||
| </ul></li> | </ul></li> | ||||||
| <li><a href="#http-proxy-for-downloading-plugins">HTTP Proxy for downloading plugins</a></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> | <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 |   password: password_or_token | ||||||
| </code></pre> | </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> | <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> | <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> |       <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> |       <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="datePublished" content="2020-04-13T00:00:00+00:00" /> | ||||||
| <meta itemprop="dateModified" 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> |       <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> | <ul> | ||||||
| <li> | <li> | ||||||
| <ul> | <ul> | ||||||
|  | <li><a href="#how-to-customize-jenkins">How to customize Jenkins</a> | ||||||
|  | <ul> | ||||||
| <li> | <li> | ||||||
| <ul> | <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> | </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></li> | ||||||
| </ul> | </ul> | ||||||
| </nav> | </nav> | ||||||
|  | @ -661,11 +671,72 @@ | ||||||
| 	<div class="lead">How to customize Jenkins</div> | 	<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>. | <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||||
| 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. | 
 | ||||||
|  | <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> | 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"> | <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>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>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. | <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> | 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. | <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> | 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> | </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> | <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 | 	<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> |       <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> |       <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> |       <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 |   password: password_or_token | ||||||
| </code></pre> | </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> | <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> | <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>. | <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||||
| 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. | 
 | ||||||
|  | <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> | 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"> | <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>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>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. | <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> | 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. | <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> | 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> | </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> | <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> |       </description> | ||||||
|     </item> |     </item> | ||||||
|      |      | ||||||
|  | @ -871,7 +893,7 @@ the number of backups under control, e.g. Cloud Formation fragment:</p> | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       slack: |       slack: | ||||||
|  | @ -891,7 +913,7 @@ spec: | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       teams: |       teams: | ||||||
|  | @ -909,7 +931,7 @@ spec: | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       mailgun: |       mailgun: | ||||||
|  | @ -927,7 +949,7 @@ spec: | ||||||
| <p>As you see there is two debugging options:</p> | <p>As you see there is two debugging options:</p> | ||||||
| 
 | 
 | ||||||
| <ul> | <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> | <li><p><code>verbose</code> - Print stacktrace and additional error messages</p></li> | ||||||
| </ul> | </ul> | ||||||
|  | @ -941,7 +963,7 @@ For example you will send notifications to Slack and Teams.</p> | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: nslack |       name: nslack | ||||||
|       slack: |       slack: | ||||||
|  | @ -949,7 +971,7 @@ spec: | ||||||
|           secret: |           secret: | ||||||
|             name: &lt;secret_name&gt; |             name: &lt;secret_name&gt; | ||||||
|           key: &lt;key&gt; |           key: &lt;key&gt; | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: nteams |       name: nteams | ||||||
|       teams: |       teams: | ||||||
|  | @ -962,6 +984,109 @@ spec: | ||||||
|       </description> |       </description> | ||||||
|     </item> |     </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> |     <item> | ||||||
|       <title>Docs: Diagnostics</title> |       <title>Docs: Diagnostics</title> | ||||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/diagnostics/</link> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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> |       <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 |   password: password_or_token | ||||||
| </code></pre> | </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> | <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> | <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>. | <h2 id="how-to-customize-jenkins">How to customize Jenkins</h2> | ||||||
| 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. | 
 | ||||||
|  | <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> | 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"> | <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>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>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. | <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> | 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. | <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> | 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> | </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> | <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> |       </description> | ||||||
|     </item> |     </item> | ||||||
|      |      | ||||||
|  | @ -2448,7 +2470,7 @@ the number of backups under control, e.g. Cloud Formation fragment:</p> | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       slack: |       slack: | ||||||
|  | @ -2468,7 +2490,7 @@ spec: | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       teams: |       teams: | ||||||
|  | @ -2486,7 +2508,7 @@ spec: | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: &lt;name&gt; |       name: &lt;name&gt; | ||||||
|       mailgun: |       mailgun: | ||||||
|  | @ -2504,7 +2526,7 @@ spec: | ||||||
| <p>As you see there is two debugging options:</p> | <p>As you see there is two debugging options:</p> | ||||||
| 
 | 
 | ||||||
| <ul> | <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> | <li><p><code>verbose</code> - Print stacktrace and additional error messages</p></li> | ||||||
| </ul> | </ul> | ||||||
|  | @ -2518,7 +2540,7 @@ For example you will send notifications to Slack and Teams.</p> | ||||||
| spec: | spec: | ||||||
|   master: |   master: | ||||||
|     notifications: |     notifications: | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: nslack |       name: nslack | ||||||
|       slack: |       slack: | ||||||
|  | @ -2526,7 +2548,7 @@ spec: | ||||||
|           secret: |           secret: | ||||||
|             name: &lt;secret_name&gt; |             name: &lt;secret_name&gt; | ||||||
|           key: &lt;key&gt; |           key: &lt;key&gt; | ||||||
|     - loggingLevel: info |     - level: info | ||||||
|       verbose: true |       verbose: true | ||||||
|       name: nteams |       name: nteams | ||||||
|       teams: |       teams: | ||||||
|  | @ -3450,6 +3472,109 @@ and add explicit references to the existing <code>ConfigMap</code> a | ||||||
|       </description> |       </description> | ||||||
|     </item> |     </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> |     <item> | ||||||
|       <title>Docs: Tools</title> |       <title>Docs: Tools</title> | ||||||
|       <link>https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/tools/</link> |       <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> |       <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> |       <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:type" content="website" /> | ||||||
| <meta property="og:url" content="https://jenkinsci.github.io/kubernetes-operator/" /> | <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="name" content="Jenkins Kubernetes Operator"> | ||||||
| <meta itemprop="description" content="A native operator for Kubernetes to manage Jenkins"> | <meta itemprop="description" content="A native operator for Kubernetes to manage Jenkins"> | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -4,7 +4,7 @@ | ||||||
|     <link>https://jenkinsci.github.io/kubernetes-operator/</link> |     <link>https://jenkinsci.github.io/kubernetes-operator/</link> | ||||||
|     <description>Recent Hugo news from gohugo.io</description> |     <description>Recent Hugo news from gohugo.io</description> | ||||||
|     <generator>Hugo -- gohugo.io</generator> |     <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> |     <image> | ||||||
|       <url>https://jenkinsci.github.io/kubernetes-operator/img/hugo.png</url> |       <url>https://jenkinsci.github.io/kubernetes-operator/img/hugo.png</url> | ||||||
|       <title>GoHugo.io</title> |       <title>GoHugo.io</title> | ||||||
|  |  | ||||||
|  | @ -182,6 +182,11 @@ | ||||||
|     <lastmod>2019-08-05T00:00:00+00:00</lastmod> |     <lastmod>2019-08-05T00:00:00+00:00</lastmod> | ||||||
|   </url> |   </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> |   <url> | ||||||
|     <loc>https://jenkinsci.github.io/kubernetes-operator/docs/</loc> |     <loc>https://jenkinsci.github.io/kubernetes-operator/docs/</loc> | ||||||
|     <lastmod>2019-09-03T00:00:00+00:00</lastmod> |     <lastmod>2019-09-03T00:00:00+00:00</lastmod> | ||||||
|  | @ -259,7 +264,7 @@ | ||||||
|    |    | ||||||
|   <url> |   <url> | ||||||
|     <loc>https://jenkinsci.github.io/kubernetes-operator/</loc> |     <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> | ||||||
|    |    | ||||||
|   <url> |   <url> | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue