DirectorySecurity AdvisoriesPricing
Sign in
Directory
jenkins logoHELM

jenkins

Helm chart
Last changed
Request a free trial

Contact our team to test out this Helm chart and related images for free. Please also indicate any other images you would like to evaluate.

Overview
Chart tags
Default values
Chart metadata
Images

Tag:
Compare:

1
# Default values for jenkins.
2
# This is a YAML-formatted file.
3
# Declare name/value pairs to be passed into your templates.
4
# name: value
5
6
## Overrides for generated resource names
7
# See templates/_helpers.tpl
8
# -- Override the resource name prefix
9
# @default -- `Chart.Name`
10
nameOverride:
11
# -- Override the full resource names
12
# @default -- `jenkins-(release-name)` or `jenkins` if the release-name is `jenkins`
13
fullnameOverride:
14
# -- Override the deployment namespace
15
# @default -- `Release.Namespace`
16
namespaceOverride:
17
# For FQDN resolving of the controller service. Change this value to match your existing configuration.
18
# ref: https://github.com/kubernetes/dns/blob/master/docs/specification.md
19
# -- Override the cluster name for FQDN resolving
20
clusterZone: "cluster.local"
21
# -- The URL of the Kubernetes API server
22
kubernetesURL: "https://kubernetes.default"
23
# -- The Jenkins credentials to access the Kubernetes API server. For the default cluster it is not needed.
24
credentialsId:
25
# -- Enables rendering of the helm.sh/chart label to the annotations
26
renderHelmLabels: true
27
# -- Configures extra labels for the agent all objects
28
extraLabels: {}
29
# -- Configures extra manifests
30
extraObjects:
31
controller:
32
# -- Used for label app.kubernetes.io/component
33
componentName: "jenkins-controller"
34
image:
35
# -- Controller image registry
36
registry: cgr.dev
37
# -- Controller image repository
38
repository: chainguard-private/jenkins
39
# -- Controller image tag override; i.e., tag: "2.440.1-jdk21"
40
tag: 2.588-r0-jdk21@sha256:6100d5610704e7ad64826cf1c38edf0e09e4d927a0070a421ff063c94b435915
41
# -- Controller image tag label
42
tagLabel: jdk25
43
# -- Controller image pull policy
44
pullPolicy: "Always"
45
# -- Number of replicas. Max 1. Can be set to 0 for maintenance scenarios.
46
replicas: 1
47
# -- Controller image pull secret
48
imagePullSecretName:
49
# -- Lifecycle specification for controller-container
50
lifecycle: {}
51
# postStart:
52
# exec:
53
# command:
54
# - "uname"
55
# - "-a"
56
57
# -- Disable use of remember me
58
disableRememberMe: false
59
# -- Set Number of executors
60
numExecutors: 0
61
# -- Sets the executor mode of the Jenkins node. Possible values are "NORMAL" or "EXCLUSIVE"
62
executorMode: "NORMAL"
63
# -- Append Jenkins labels to the controller
64
customJenkinsLabels: []
65
hostNetworking: false
66
# When enabling LDAP or another non-Jenkins identity source, the built-in admin account will no longer exist.
67
# If you disable the non-Jenkins identity store and instead use the Jenkins internal one,
68
# you should revert controller.admin.username to your preferred admin user:
69
admin:
70
# -- Admin username created as a secret if `controller.admin.createSecret` is true
71
username: "admin"
72
# -- Admin password created as a secret if `controller.admin.createSecret` is true
73
# @default -- <random password>
74
password:
75
# -- The key in the existing admin secret containing the username
76
userKey: jenkins-admin-user
77
# -- The key in the existing admin secret containing the password
78
passwordKey: jenkins-admin-password
79
# The default configuration uses this secret to configure an admin user
80
# If you don't need that user or use a different security realm, then you can disable it
81
# -- Create secret for admin user
82
createSecret: true
83
# -- The name of an existing secret containing the admin credentials
84
existingSecret: ""
85
# -- Email address for the administrator of the Jenkins instance
86
jenkinsAdminEmail:
87
# This value should not be changed unless you use your custom image of jenkins or any derived from.
88
# If you want to use Cloudbees Jenkins Distribution docker, you should set jenkinsHome: "/var/cloudbees-jenkins-distribution"
89
# -- Custom Jenkins home path
90
jenkinsHome: "/var/jenkins_home"
91
# This value should not be changed unless you use your custom image of jenkins or any derived from.
92
# If you want to use Cloudbees Jenkins Distribution docker, you should set jenkinsRef: "/usr/share/cloudbees-jenkins-distribution/ref"
93
# -- Custom Jenkins reference path
94
jenkinsRef: "/usr/share/jenkins/ref"
95
# Path to the jenkins war file which is used by jenkins-plugin-cli.
96
jenkinsWar: "/usr/share/jenkins/jenkins.war"
97
# Override the default arguments passed to the war
98
# overrideArgs:
99
# - --httpPort=8080
100
101
# -- Resource allocation (Requests and Limits)
102
resources:
103
requests:
104
cpu: "50m"
105
memory: "256Mi"
106
limits:
107
cpu: "2000m"
108
memory: "4096Mi"
109
# Share process namespace to allow sidecar containers to interact with processes in other containers in the same pod
110
shareProcessNamespace: false
111
# Service links might cause issue if running in a namespace with a large amount of services
112
# that might cause a slow startup when plugins are copied from ref to volume
113
# Set to true to keep previous behavior
114
# See https://github.com/kubernetes/kubernetes/issues/121787
115
enableServiceLinks: false
116
# Overrides the init container default values
117
# -- Resources allocation (Requests and Limits) for Init Container
118
initContainerResources: {}
119
# initContainerResources:
120
# requests:
121
# cpu: "50m"
122
# memory: "256Mi"
123
# limits:
124
# cpu: "2000m"
125
# memory: "4096Mi"
126
# -- Environment variable sources for Init Container
127
initContainerEnvFrom: []
128
# useful for i.e., http_proxy
129
# -- Environment variables for Init Container
130
initContainerEnv: []
131
# initContainerEnv:
132
# - name: http_proxy
133
# value: "http://192.168.64.1:3128"
134
135
# -- Environment variable sources for Jenkins Container
136
containerEnvFrom: []
137
# -- Environment variables for Jenkins Container
138
containerEnv: []
139
# - name: http_proxy
140
# value: "http://192.168.64.1:3128"
141
142
# Set min/max heap here if needed with "-Xms512m -Xmx512m"
143
# -- Append to `JAVA_OPTS` env var
144
javaOpts:
145
# -- Append to `JENKINS_OPTS` env var
146
jenkinsOpts:
147
# If you are using the ingress definitions provided by this chart via the `controller.ingress` block,
148
# the configured hostname will be the ingress hostname starting with `https://`
149
# or `http://` depending on the `tls` configuration.
150
# The Protocol can be overwritten by specifying `controller.jenkinsUrlProtocol`.
151
# -- Set protocol for Jenkins URL; `https` if `controller.ingress.tls`, `http` otherwise
152
jenkinsUrlProtocol:
153
# -- Set Jenkins URL if you are not using the ingress definitions provided by the chart
154
jenkinsUrl:
155
# If you set this prefix and use ingress controller, then you might want to set the ingress path below
156
# I.e., "/jenkins"
157
# -- Root URI Jenkins will be served on
158
jenkinsUriPrefix:
159
# -- Enable pod security context (must be `true` if podSecurityContextOverride, runAsUser or fsGroup are set)
160
usePodSecurityContext: true
161
# Note that `runAsUser`, `fsGroup`, and `securityContextCapabilities` are
162
# being deprecated and replaced by `podSecurityContextOverride`.
163
# Set runAsUser to 1000 to let Jenkins run as non-root user 'jenkins', which exists in 'jenkins/jenkins' docker image.
164
# When configuring runAsUser to a different value than 0 also set fsGroup to the same value:
165
# -- Deprecated in favor of `controller.podSecurityContextOverride`. uid that jenkins runs with.
166
runAsUser: 1000
167
# -- Deprecated in favor of `controller.podSecurityContextOverride`. uid that will be used for persistent volume.
168
fsGroup: 1000
169
# -- Deprecated in favor of `controller.podSecurityContextOverride`. fsGroupChangePolicy for the pod security context
170
fsGroupChangePolicy: OnRootMismatch
171
# If you have PodSecurityPolicies that require dropping of capabilities as suggested by CIS K8s benchmark, put them here
172
# securityContextCapabilities:
173
# drop:
174
# - NET_RAW
175
securityContextCapabilities: {}
176
# In the case of mounting an ext4 filesystem, it might be desirable to use `supplementalGroups` instead of `fsGroup` in
177
# the `securityContext` block: https://github.com/kubernetes/kubernetes/issues/67014#issuecomment-589915496
178
# podSecurityContextOverride:
179
# runAsUser: 1000
180
# runAsNonRoot: true
181
# supplementalGroups: [1000]
182
# capabilities: {}
183
# -- Completely overwrites the contents of the pod security context, ignoring the values provided for `runAsUser`, `fsGroup`, and `securityContextCapabilities`
184
podSecurityContextOverride: ~
185
# -- Allow controlling the securityContext for the jenkins container
186
containerSecurityContext:
187
runAsUser: 1000
188
runAsGroup: 1000
189
readOnlyRootFilesystem: true
190
allowPrivilegeEscalation: false
191
capabilities:
192
drop:
193
- ALL
194
seccompProfile:
195
type: RuntimeDefault
196
# -- enable or disable the controller k8s service
197
serviceEnabled: true
198
# For minikube, set this to NodePort, elsewhere uses LoadBalancer
199
# Use ClusterIP if your setup includes ingress controller
200
# -- k8s service type
201
serviceType: ClusterIP
202
# -- k8s service clusterIP. Only used if serviceType is ClusterIP
203
clusterIp:
204
# -- k8s service port
205
servicePort: 8080
206
# -- k8s target port
207
targetPort: 8080
208
# -- k8s node port. Only used if serviceType is NodePort
209
nodePort:
210
# Use Local to preserve the client source IP and avoids a second hop for LoadBalancer and NodePort type services,
211
# but risks potentially imbalanced traffic spreading.
212
serviceExternalTrafficPolicy:
213
# If enabled, the controller is available through its service before its pods reports ready. Makes startup screen and
214
# auto-reload on restart feature possible.
215
publishNotReadyAddresses:
216
# -- Jenkins controller service annotations
217
serviceAnnotations: {}
218
# -- Jenkins controller custom labels for the StatefulSet
219
statefulSetLabels: {}
220
# foo: bar
221
# bar: foo
222
# -- Labels for the Jenkins controller-service
223
serviceLabels: {}
224
# service.beta.kubernetes.io/aws-load-balancer-backend-protocol: https
225
226
# Put labels on Jenkins controller pod
227
# -- Custom Pod labels (an object with `label-key: label-value` pairs)
228
podLabels: {}
229
# Enable Kubernetes Startup, Liveness and Readiness Probes
230
# if Startup Probe is supported, enable it too
231
# ~ 2 minutes to allow Jenkins to restart when upgrading plugins. Set ReadinessTimeout to be shorter than LivenessTimeout.
232
# ref: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes
233
# -- Enable Kubernetes Probes configuration configured in `controller.probes`
234
healthProbes: true
235
probes:
236
startupProbe:
237
# -- Set the failure threshold for the startup probe
238
failureThreshold: 12
239
httpGet:
240
# -- Set the Pod's HTTP path for the startup probe
241
path: '{{ default "" .Values.controller.jenkinsUriPrefix }}/login'
242
# -- Set the Pod's HTTP port to use for the startup probe
243
port: http
244
# -- Set the time interval between two startup probes executions in seconds
245
periodSeconds: 10
246
# -- Set the timeout for the startup probe in seconds
247
timeoutSeconds: 5
248
livenessProbe:
249
# -- Set the failure threshold for the liveness probe
250
failureThreshold: 5
251
httpGet:
252
# -- Set the Pod's HTTP path for the liveness probe
253
path: '{{ default "" .Values.controller.jenkinsUriPrefix }}/login'
254
# -- Set the Pod's HTTP port to use for the liveness probe
255
port: http
256
# -- Set the time interval between two liveness probes executions in seconds
257
periodSeconds: 10
258
# -- Set the timeout for the liveness probe in seconds
259
timeoutSeconds: 5
260
# If Startup Probe is not supported on your Kubernetes cluster, you might want to use "initialDelaySeconds" instead.
261
# It delays the initial liveness probe while Jenkins is starting
262
# -- Set the initial delay for the liveness probe in seconds
263
initialDelaySeconds:
264
readinessProbe:
265
# -- Set the failure threshold for the readiness probe
266
failureThreshold: 3
267
httpGet:
268
# -- Set the Pod's HTTP path for the liveness probe
269
path: '{{ default "" .Values.controller.jenkinsUriPrefix }}/login'
270
# -- Set the Pod's HTTP port to use for the readiness probe
271
port: http
272
# -- Set the time interval between two readiness probes executions in seconds
273
periodSeconds: 10
274
# -- Set the timeout for the readiness probe in seconds
275
timeoutSeconds: 5
276
# If Startup Probe is not supported on your Kubernetes cluster, you might want to use "initialDelaySeconds" instead.
277
# It delays the initial readiness probe while Jenkins is starting
278
# -- Set the initial delay for the readiness probe in seconds
279
initialDelaySeconds:
280
# PodDisruptionBudget config
281
podDisruptionBudget:
282
# ref: https://kubernetes.io/docs/tasks/run-application/configure-pdb/
283
284
# -- Enable Kubernetes Pod Disruption Budget configuration
285
enabled: false
286
# For Kubernetes v1.5+, use 'policy/v1beta1'
287
# For Kubernetes v1.21+, use 'policy/v1'
288
# -- Policy API version
289
apiVersion: "policy/v1beta1"
290
annotations: {}
291
labels: {}
292
# -- Number of pods that can be unavailable. Either an absolute number or a percentage
293
maxUnavailable: "0"
294
# -- Create Agent listener service
295
agentListenerEnabled: true
296
# -- Listening port for agents
297
agentListenerPort: 50000
298
# -- Host port to listen for agents
299
agentListenerHostPort:
300
# -- Node port to listen for agents
301
agentListenerNodePort:
302
# ref: https://kubernetes.io/docs/concepts/services-networking/service/#traffic-policies
303
# -- Traffic Policy of for the agentListener service
304
agentListenerExternalTrafficPolicy:
305
# -- Allowed inbound IP for the agentListener service
306
agentListenerLoadBalancerSourceRanges:
307
- 0.0.0.0/0
308
# -- Disabled agent protocols
309
disabledAgentProtocols:
310
- JNLP-connect
311
- JNLP2-connect
312
csrf:
313
defaultCrumbIssuer:
314
# -- Enable the default CSRF Crumb issuer
315
enabled: true
316
# -- Enable proxy compatibility. This setting is ignored if you are not on the current LTS release and will be dropped with the next LTS.
317
proxyCompatability: true
318
# Kubernetes service type for the JNLP agent service
319
# agentListenerServiceType is the Kubernetes Service type for the JNLP agent service,
320
# either 'LoadBalancer', 'NodePort', or 'ClusterIP'
321
# Note if you set this to 'LoadBalancer', you *must* define annotations to secure it. By default,
322
# this will be an external load balancer and allowing inbound 0.0.0.0/0, a HUGE
323
# security risk: https://github.com/kubernetes/charts/issues/1341
324
# -- Defines how to expose the agentListener service
325
agentListenerServiceType: "ClusterIP"
326
# -- Annotations for the agentListener service
327
agentListenerServiceAnnotations: {}
328
# Optionally, assign an IP to the LoadBalancer agentListenerService LoadBalancer
329
# GKE users: only regional static IPs will work for Service Load balancer.
330
# -- Static IP for the agentListener LoadBalancer
331
agentListenerLoadBalancerIP:
332
# -- Whether legacy remoting security should be enabled
333
legacyRemotingSecurityEnabled: false
334
# Example of a 'LoadBalancer'-type agent listener with annotations securing it
335
# agentListenerServiceType: LoadBalancer
336
# agentListenerServiceAnnotations:
337
# service.beta.kubernetes.io/aws-load-balancer-internal: "True"
338
# service.beta.kubernetes.io/load-balancer-source-ranges: "172.0.0.0/8, 10.0.0.0/8"
339
340
# LoadBalancerSourcesRange is a list of allowed CIDR values, which are combined with ServicePort to
341
# set allowed inbound rules on the security group assigned to the controller load balancer
342
# -- Allowed inbound IP addresses
343
loadBalancerSourceRanges:
344
- 0.0.0.0/0
345
# -- Optionally assign a known public LB IP
346
loadBalancerIP:
347
# Optionally configure a JMX port. This requires additional javaOpts, for example,
348
# javaOpts: >
349
# -Dcom.sun.management.jmxremote.port=4000
350
# -Dcom.sun.management.jmxremote.authenticate=false
351
# -Dcom.sun.management.jmxremote.ssl=false
352
# jmxPort: 4000
353
# -- Open a port, for JMX stats
354
jmxPort:
355
# -- Optionally configure other ports to expose in the controller container
356
extraPorts: []
357
# - name: BuildInfoProxy
358
# port: 9000
359
# targetPort: 9010 (Optional: Use to explicitly set targetPort if different from port)
360
361
# Plugins will be installed during Jenkins controller start
362
# -- List of Jenkins plugins to install. If you don't want to install plugins, set it to `false`
363
installPlugins:
364
- kubernetes:4560.vc25b_83890c34
365
- workflow-aggregator:608.v67378e9d3db_1
366
- git:5.11.0
367
- configuration-as-code:2143.vc78d4eb_d4174
368
# If set to false, Jenkins will download the minimum required version of all dependencies.
369
# -- Download the minimum required version or latest version of all dependencies
370
installLatestPlugins: true
371
# -- Set to true to download the latest version of any plugin that is requested to have the latest version
372
installLatestSpecifiedPlugins: false
373
# -- List of plugins to install in addition to those listed in controller.installPlugins
374
additionalPlugins: []
375
# Without this; whenever the controller gets restarted (Evicted, etc.) it will fetch plugin updates that have the potential to cause breakage.
376
# Note that for this to work, `persistence.enabled` needs to be set to `true`
377
# -- Initialize only on first installation. Ensures plugins do not get updated inadvertently. Requires `persistence.enabled` to be set to `true`
378
initializeOnce: false
379
# Enable to always override the installed plugins with the values of 'controller.installPlugins' on upgrade or redeployment.
380
# -- Overwrite installed plugins on start
381
overwritePlugins: false
382
# Configures if plugins bundled with `controller.image` should be overwritten with the values of 'controller.installPlugins' on upgrade or redeployment.
383
# -- Overwrite plugins that are already installed in the controller image
384
overwritePluginsFromImage: true
385
# Configures the restrictions for naming projects. Set this key to null or empty to skip it in the default config.
386
projectNamingStrategy: standard
387
# Useful with ghprb plugin. The OWASP plugin is not installed by default, please update controller.installPlugins.
388
# -- Enable HTML parsing using OWASP Markup Formatter Plugin (antisamy-markup-formatter)
389
enableRawHtmlMarkupFormatter: false
390
# This is ignored if enableRawHtmlMarkupFormatter is true
391
# -- Yaml of the markup formatter to use
392
markupFormatter: plainText
393
# Used to approve a list of groovy functions in pipelines used the script-security plugin. Can be viewed under /scriptApproval
394
# -- List of groovy functions to approve
395
scriptApproval: []
396
# - "method groovy.json.JsonSlurperClassic parseText java.lang.String"
397
# - "new groovy.json.JsonSlurperClassic"
398
399
# -- Map of groovy init scripts to be executed during Jenkins controller start
400
initScripts: {}
401
# test: |-
402
# print 'adding global pipeline libraries, register properties, bootstrap jobs...'
403
# -- Name of the existing ConfigMap that contains init scripts
404
initConfigMap:
405
# 'name' is a name of an existing secret in the same namespace as jenkins,
406
# 'keyName' is the name of one of the keys inside the current secret.
407
# the 'name' and 'keyName' are concatenated with a '-' in between, so for example:
408
# an existing secret "secret-credentials" and a key inside it named "github-password" should be used in JCasC as ${secret-credentials-github-password}
409
# 'name' and 'keyName' must be lowercase RFC 1123 label must consist of lower case alphanumeric characters or '-',
410
# and must start and end with an alphanumeric character (e.g. 'my-name', or '123-abc')
411
# existingSecret existing secret "secret-credentials" and a key inside it named "github-username" should be used in JCasC as ${github-username}
412
# When using existingSecret no need to specify the keyName under additionalExistingSecrets.
413
existingSecret:
414
# -- List of additional existing secrets to mount
415
additionalExistingSecrets: []
416
# ref: https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/secrets.adoc#kubernetes-secrets
417
# additionalExistingSecrets:
418
# - name: secret-name-1
419
# keyName: username
420
# - name: secret-name-1
421
# keyName: password
422
423
# -- List of additional secrets to create and mount
424
additionalSecrets: []
425
# ref: https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/secrets.adoc#kubernetes-secrets
426
# additionalSecrets:
427
# - name: nameOfSecret
428
# value: secretText
429
430
# Generate SecretClaim resources to create Kubernetes secrets from HashiCorp Vault using kube-vault-controller.
431
# 'name' is the name of the secret that will be created in Kubernetes. The Jenkins fullname is prepended to this value.
432
# 'path' is the fully qualified path to the secret in Vault
433
# 'type' is an optional Kubernetes secret type. The default is 'Opaque'
434
# 'renew' is an optional secret renewal time in seconds
435
# -- List of `SecretClaim` resources to create
436
secretClaims: []
437
# - name: secretName # required
438
# path: testPath # required
439
# type: kubernetes.io/tls # optional
440
# renew: 60 # optional
441
442
# -- Name of default cloud configuration.
443
cloudName: "kubernetes"
444
# -- Traits for the chart-generated Kubernetes cloud (for example, `ephemeralContainer`). Additional clouds inherit these unless overridden by `additionalClouds.<name>.controller.cloudTraits`.
445
cloudTraits: []
446
# Below is the implementation of Jenkins Configuration as Code. Add a key under configScripts for each configuration area,
447
# where each corresponds to a plugin or section of the UI. Each key (prior to | character) is just a label, and can be any value.
448
# Keys are only used to give the section a meaningful name. The only restriction is they may only contain RFC 1123 \ DNS label
449
# characters: lowercase letters, numbers, and hyphens. The keys become the name of a configuration yaml file on the controller in
450
# /var/jenkins_home/casc_configs (by default) and will be processed by the Configuration as Code Plugin. The lines after each |
451
# become the content of the configuration yaml file. The first line after this is a JCasC root element, e.g., jenkins, credentials,
452
# etc. Best reference is https://<jenkins_url>/configuration-as-code/reference. The example below creates a welcome message:
453
JCasC:
454
# -- Enables default Jenkins configuration via configuration as code plugin
455
defaultConfig: true
456
# If true, the init container deletes all the plugin config files and Jenkins Config as Code overwrites any existing configuration
457
# -- Whether Jenkins Config as Code should overwrite any existing configuration
458
overwriteConfiguration: false
459
# -- Remote URLs for configuration files.
460
configUrls: []
461
# - https://acme.org/jenkins.yaml
462
# -- List of Jenkins Config as Code scripts
463
configScripts: {}
464
# welcome-message: |
465
# jenkins:
466
# systemMessage: Welcome to our CI\CD server. This Jenkins is configured and managed 'as code'.
467
468
# Allows adding to the top-level security JCasC section. For legacy purposes, by default, the chart includes apiToken configurations
469
# -- Jenkins Config as Code security-section
470
security:
471
apiToken:
472
creationOfLegacyTokenEnabled: false
473
tokenGenerationOnCreationEnabled: false
474
usageStatisticsEnabled: true
475
# Ignored if securityRealm is defined in controller.JCasC.configScripts
476
# -- Jenkins Config as Code Security Realm-section
477
securityRealm: |-
478
local:
479
allowsSignup: false
480
enableCaptcha: false
481
users:
482
- id: "${chart-admin-username}"
483
name: "Jenkins Admin"
484
password: "${chart-admin-password}"
485
# Ignored if authorizationStrategy is defined in controller.JCasC.configScripts
486
# -- Jenkins Config as Code Authorization Strategy-section
487
authorizationStrategy: |-
488
loggedInUsersCanDoAnything:
489
allowAnonymousRead: false
490
# -- Annotations for the JCasC ConfigMap
491
configMapAnnotations: {}
492
# -- Custom init-container specification in raw-yaml format
493
customInitContainers: []
494
# - name: custom-init
495
# image: "alpine:3"
496
# imagePullPolicy: Always
497
# command: [ "uname", "-a" ]
498
499
sidecars:
500
configAutoReload:
501
# If enabled: true, Jenkins Configuration as Code will be reloaded on-the-fly without a reboot.
502
# If false or not-specified, JCasC changes will cause a reboot and will only be applied at the subsequent start-up.
503
# Auto-reload uses the http://<jenkins_url>/reload-configuration-as-code endpoint to reapply config when changes to
504
# the configScripts are detected.
505
# -- Enable Jenkins Config as Code auto-reload
506
enabled: true
507
image:
508
# -- Registry for the image that triggers the reload
509
registry: cgr.dev
510
# -- Repository of the image that triggers the reload
511
repository: chainguard-private/k8s-sidecar
512
# -- Tag for the image that triggers the reload
513
tag: 2.14.3-r0@sha256:f75b2664e36c0e9dc19e03f229b57aa3b021d3a99995a69c13aa1af0d5e15537
514
imagePullPolicy: IfNotPresent
515
# -- Port for sidecar health probes
516
healthPort: 8060
517
resources: {}
518
# limits:
519
# cpu: 100m
520
# memory: 100Mi
521
# requests:
522
# cpu: 50m
523
# memory: 50Mi
524
# -- Enables additional volume mounts for the config auto-reload container
525
additionalVolumeMounts: []
526
# - name: auto-reload-config
527
# mountPath: /var/config/logger
528
# - name: auto-reload-logs
529
# mountPath: /var/log/auto_reload
530
# -- Config auto-reload logging settings
531
logging:
532
# See default settings https://github.com/kiwigrid/k8s-sidecar/blob/master/src/logger.py
533
configuration:
534
# -- Enables custom log config utilizing using the settings below.
535
override: false
536
logLevel: INFO
537
formatter: JSON
538
logToConsole: true
539
logToFile: false
540
maxBytes: 1024
541
backupCount: 3
542
# -- The scheme to use when connecting to the Jenkins configuration as code endpoint
543
scheme: http
544
# -- Skip TLS verification when connecting to the Jenkins configuration as code endpoint
545
skipTlsVerify: false
546
# -- How many connection-related errors to retry on
547
reqRetryConnect: 10
548
# -- How many seconds to wait before updating config-maps/secrets (sets METHOD=SLEEP on the sidecar)
549
sleepTime:
550
# -- Environment variable sources for the Jenkins Config as Code auto-reload container
551
envFrom: []
552
# -- Environment variables for the Jenkins Config as Code auto-reload container
553
env: []
554
# - name: REQ_TIMEOUT
555
# value: "30"
556
557
# SSH port value can be set to any unused TCP port. The default, 1044, is a non-standard SSH port that has been chosen at random.
558
# This is only used to reload JCasC config from the sidecar container running in the Jenkins controller pod.
559
# This TCP port will not be open in the pod (unless you specifically configure this), so Jenkins will not be
560
# accessible via SSH from outside the pod. Note if you use non-root pod privileges (runAsUser & fsGroup),
561
# this must be > 1024:
562
sshTcpPort: 1044
563
# folder in the pod that should hold the collected dashboards:
564
folder: "/var/jenkins_home/casc_configs"
565
# If specified, the sidecar will search for JCasC config-maps inside this namespace.
566
# Otherwise, the namespace in which the sidecar is running will be used.
567
# It's also possible to specify ALL to search in all namespaces:
568
# searchNamespace:
569
# -- Enable container security context
570
containerSecurityContext:
571
readOnlyRootFilesystem: true
572
allowPrivilegeEscalation: false
573
capabilities:
574
drop:
575
- ALL
576
seccompProfile:
577
type: RuntimeDefault
578
# -- Configures additional sidecar container(s) for the Jenkins controller
579
additionalSidecarContainers: []
580
## The example below runs the client for https://smee.io as sidecar container next to Jenkins,
581
## that allows triggering build behind a secure firewall.
582
## https://jenkins.io/blog/2019/01/07/webhook-firewalls/#triggering-builds-with-webhooks-behind-a-secure-firewall
583
##
584
## Note: To use it you should go to https://smee.io/new and update the url to the generated one.
585
# - name: smee
586
# image: docker.io/twalter/smee-client:1.0.2
587
# args: ["--port", "{{ .Values.controller.servicePort }}", "--path", "/github-webhook/", "--url", "https://smee.io/new"]
588
# resources:
589
# limits:
590
# cpu: 50m
591
# memory: 128Mi
592
# requests:
593
# cpu: 10m
594
# memory: 32Mi
595
# -- Name of the Kubernetes scheduler to use
596
schedulerName: ""
597
# ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector
598
# -- Node labels for pod assignment
599
nodeSelector: {}
600
# ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#taints-and-tolerations-beta-feature
601
# -- Toleration labels for pod assignment
602
tolerations: []
603
# -- Set TerminationGracePeriodSeconds
604
terminationGracePeriodSeconds:
605
# -- Set the termination message path
606
terminationMessagePath:
607
# -- Set the termination message policy
608
terminationMessagePolicy:
609
# -- Affinity settings
610
affinity: {}
611
# Leverage a priorityClass to ensure your pods survive resource shortages
612
# ref: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/
613
# -- The name of a `priorityClass` to apply to the controller pod
614
priorityClassName:
615
# -- Annotations for controller pod
616
podAnnotations: {}
617
# -- Annotations for controller StatefulSet
618
statefulSetAnnotations: {}
619
# ref: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#update-strategies
620
# -- Update strategy for StatefulSet
621
updateStrategy: {}
622
# ref: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#managing-revision-history
623
# -- Maximum number of revisions that will be maintained in the StatefulSet's revision history
624
revisionHistoryLimit:
625
# -- Topology spread constraints
626
topologySpreadConstraints: []
627
# -- DNS config for the pod
628
dnsConfig: {}
629
ingress:
630
# -- Enables the Primary ingress
631
enabled: false
632
# Override for the default paths that map requests to the backend
633
# -- Override for the default Primary Ingress paths
634
paths: []
635
# - backend:
636
# serviceName: ssl-redirect
637
# servicePort: use-annotation
638
# - backend:
639
# serviceName: >-
640
# {{ template "jenkins.fullname" . }}
641
# # Don't use string here, use only integer value!
642
# servicePort: 8080
643
644
# -- Primary Ingress rule pathType, choices are: Exact, ImplementationSpecific, Prefix
645
pathType: ImplementationSpecific
646
# For Kubernetes v1.14+, use 'networking.k8s.io/v1beta1'
647
# For Kubernetes v1.19+, use 'networking.k8s.io/v1'
648
# -- Primary Ingress API version
649
apiVersion: "networking.k8s.io/v1"
650
# -- Primary Ingress labels
651
labels: {}
652
# -- Primary Ingress annotations
653
annotations: {}
654
# kubernetes.io/ingress.class: nginx
655
# kubernetes.io/tls-acme: "true"
656
# For Kubernetes >= 1.18 you should specify the ingress-controller via the field ingressClassName
657
# See https://kubernetes.io/blog/2020/04/02/improvements-to-the-ingress-api-in-kubernetes-1.18/#specifying-the-class-of-an-ingress
658
# ingressClassName: nginx
659
# -- Primary Ingress ingressClassName
660
ingressClassName:
661
# Set this path to jenkinsUriPrefix above or use annotations to rewrite path
662
# -- Primary Ingress path
663
path:
664
# configures the hostname e.g. jenkins.example.com
665
# -- Primary Ingress hostname
666
hostName:
667
# -- Primary Hostname to serve assets from
668
resourceRootUrl:
669
# -- Primary Ingress TLS configuration
670
tls: []
671
# - secretName: jenkins.cluster.local
672
# hosts:
673
# - jenkins.cluster.local
674
# often you want to have your controller all locked down and private,
675
# but you still want to get webhooks from your SCM
676
# A secondary ingress will let you expose different urls
677
# with a different configuration
678
secondaryingress:
679
# -- Enables the Secondary Ingress
680
enabled: false
681
# paths you want forwarded to the backend
682
# ex /github-webhook
683
# -- Secondary Ingress paths
684
paths: []
685
# -- Secondary Ingress rule pathType, choices are: Exact, ImplementationSpecific, Prefix
686
pathType: ImplementationSpecific
687
# For Kubernetes v1.14+, use 'networking.k8s.io/v1beta1'
688
# For Kubernetes v1.19+, use 'networking.k8s.io/v1'
689
# -- Secondary Ingress API version
690
apiVersion: "networking.k8s.io/v1"
691
# -- Secondary Ingress labels
692
labels: {}
693
# -- Secondary Ingress annotations
694
annotations: {}
695
# kubernetes.io/ingress.class: nginx
696
# kubernetes.io/tls-acme: "true"
697
# For Kubernetes >= 1.18 you should specify the ingress-controller via the field ingressClassName
698
# See https://kubernetes.io/blog/2020/04/02/improvements-to-the-ingress-api-in-kubernetes-1.18/#specifying-the-class-of-an-ingress
699
# -- Secondary Ingress ingressClassName
700
ingressClassName:
701
# configures the hostname e.g., jenkins-external.example.com
702
# -- Secondary Ingress hostname
703
hostName:
704
# -- Secondary Ingress TLS configuration
705
tls:
706
# - secretName: jenkins-external.example.com
707
# hosts:
708
# - jenkins-external.example.com
709
# If you're running on GKE and need to configure a backendconfig
710
# to finish ingress setup, use the following values.
711
# Docs: https://cloud.google.com/kubernetes-engine/docs/concepts/backendconfig
712
backendconfig:
713
# -- Enables backendconfig
714
enabled: false
715
# -- backendconfig API version
716
apiVersion: "extensions/v1beta1"
717
# -- backendconfig name
718
name:
719
# -- backendconfig labels
720
labels: {}
721
# -- backendconfig annotations
722
annotations: {}
723
# -- backendconfig spec
724
spec: {}
725
# Openshift route
726
route:
727
# -- Enables openshift route
728
enabled: false
729
# -- Route labels
730
labels: {}
731
# -- Route annotations
732
annotations: {}
733
# -- Route path
734
path:
735
# Gateway API HTTPRoute
736
httpRoute:
737
# Toggle to create an HTTPRoute resource alongside the existing ingress definition
738
enabled: false
739
apiVersion: "gateway.networking.k8s.io/v1"
740
kind: HTTPRoute
741
# specify the Gateway instance to bind the HTTPRoute to.
742
parentRefs: []
743
# - name: envoy-gateway-bundle
744
# namespace: envoy-gateway-system
745
# Reuse ingress host information if true; set to false to manage hostnames below
746
reuseIngressConfiguration: false
747
# Hostnames to use for the http route, only used if reuseIngressConfiguration is false.
748
hostnames: []
749
# Extra HTTPRoute rules that will be appended before the default backend
750
extraRules: []
751
# -- HTTPRoute annotations
752
annotations: {}
753
# -- Filters applied to the default HTTPRoute rule
754
filters: []
755
# -- Timeouts applied to the default HTTPRoute rule. Requires Gateway API v1.2+ and controller support
756
timeouts: {}
757
# -- Allows for adding entries to Pod /etc/hosts
758
hostAliases: []
759
# ref: https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/
760
# hostAliases:
761
# - ip: 192.168.50.50
762
# hostnames:
763
# - something.local
764
# - ip: 10.0.50.50
765
# hostnames:
766
# - other.local
767
768
# Expose Prometheus metrics
769
prometheus:
770
# If enabled, add the prometheus plugin to the list of plugins to install
771
# https://plugins.jenkins.io/prometheus
772
773
# -- Enables prometheus service monitor
774
enabled: false
775
# -- Additional labels to add to the service monitor object
776
serviceMonitorAdditionalLabels: {}
777
# -- Set a custom namespace where to deploy ServiceMonitor resource
778
serviceMonitorNamespace:
779
# -- How often prometheus should scrape metrics
780
scrapeInterval: 60s
781
# Defaults to the default endpoint used by the prometheus plugin
782
# -- The endpoint prometheus should get metrics from
783
scrapeEndpoint: /prometheus
784
# See here: https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/
785
# The `groups` root object is added by default, add the rule entries
786
# -- Array of prometheus alerting rules
787
alertingrules: []
788
# -- Additional labels to add to the PrometheusRule object
789
alertingRulesAdditionalLabels: {}
790
# -- Set a custom namespace where to deploy PrometheusRule resource
791
prometheusRuleNamespace: ""
792
# RelabelConfigs to apply to samples before scraping. Prometheus Operator automatically adds
793
# relabelings for a few standard Kubernetes fields. The original scrape job’s name
794
# is available via the __tmp_prometheus_job_name label.
795
# More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
796
relabelings: []
797
# MetricRelabelConfigs to apply to samples before ingestion.
798
metricRelabelings: []
799
googlePodMonitor:
800
# If enabled, It creates Google Managed Prometheus scraping config
801
enabled: false
802
# Set a custom namespace where to deploy PodMonitoring resource
803
# serviceMonitorNamespace: ""
804
scrapeInterval: 60s
805
# This is the default endpoint used by the prometheus plugin
806
scrapeEndpoint: /prometheus
807
# -- Can be used to disable rendering controller test resources when using helm template
808
testEnabled: true
809
httpsKeyStore:
810
# -- Enables HTTPS keystore on jenkins controller
811
enable: false
812
# -- Name of the secret that already has SSL keystore
813
jenkinsHttpsJksSecretName: ""
814
# -- Name of the key in the secret that already has SSL keystore
815
jenkinsHttpsJksSecretKey: "jenkins-jks-file"
816
# -- Name of the secret that contains the JKS password, if it is not in the same secret as the JKS file
817
jenkinsHttpsJksPasswordSecretName: ""
818
# -- Name of the key in the secret that contains the JKS password
819
jenkinsHttpsJksPasswordSecretKey: "https-jks-password"
820
disableSecretMount: false
821
# When HTTPS keystore is enabled, servicePort and targetPort will be used as HTTPS port
822
# -- HTTP Port that Jenkins should listen to along with HTTPS, it also serves as the liveness and readiness probes port.
823
httpPort: 8081
824
# -- Path of HTTPS keystore file
825
path: "/var/jenkins_keystore"
826
# -- Jenkins keystore filename which will appear under controller.httpsKeyStore.path
827
fileName: "keystore.jks"
828
# -- Jenkins keystore password
829
password: "password"
830
# -- Base64 encoded Keystore content. Keystore must be converted to base64 then being pasted here
831
jenkinsKeyStoreBase64Encoded:
832
# Convert keystore.jks files content to base64 > $ cat keystore.jks | base64
833
# /u3+7QAAAAIAAAABAAAAAQANamVua2luc2NpLmNvbQAAAW2r/b1ZAAAFATCCBP0wDgYKKwYBBAEq
834
# AhEBAQUABIIE6QbCqasvoHS0pSwYqSvdydMCB9t+VNfwhFIiiuAelJfO5sSe2SebJbtwHgLcRz1Z
835
# gMtWgOSFdl3bWSzA7vrW2LED52h+jXLYSWvZzuDuh8hYO85m10ikF6QR+dTi4jra0whIFDvq3pxe
836
# TnESxEsN+DvbZM3jA3qsjQJSeISNpDjO099dqQvHpnCn18lyk7J4TWJ8sOQQb1EM2zDAfAOSqA/x
837
# QuPEFl74DlY+5DIk6EBvpmWhaMSvXzWZACGA0sYqa157dq7O0AqmuLG/EI5EkHETO4CrtBW+yLcy
838
# 2dUCXOMA+j+NjM1BjrQkYE5vtSfNO6lFZcISyKo5pTFlcA7ut0Fx2nZ8GhHTn32CpeWwNcZBn1gR
839
# pZVt6DxVVkhTAkMLhR4rL2wGIi/1WRs23ZOLGKtyDNvDHnQyDiQEoJGy9nAthA8aNHa3cfdF10vB
840
# Drb19vtpFHmpvKEEhpk2EBRF4fTi644Fuhu2Ied6118AlaPvEea+n6G4vBz+8RWuVCmZjLU+7h8l
841
# Hy3/WdUPoIL5eW7Kz+hS+sRTFzfu9C48dMkQH3a6f3wSY+mufizNF9U298r98TnYy+PfDJK0bstG
842
# Ph6yPWx8DGXKQBwrhWJWXI6JwZDeC5Ny+l8p1SypTmAjpIaSW3ge+KgcL6Wtt1R5hUV1ajVwVSUi
843
# HF/FachKqPqyLJFZTGjNrxnmNYpt8P1d5JTvJfmfr55Su/P9n7kcyWp7zMcb2Q5nlXt4tWogOHLI
844
# OzEWKCacbFfVHE+PpdrcvCVZMDzFogIq5EqGTOZe2poPpBVE+1y9mf5+TXBegy5HToLWvmfmJNTO
845
# NCDuBjgLs2tdw2yMPm4YEr57PnMX5gGTC3f2ZihXCIJDCRCdQ9sVBOjIQbOCzxFXkVITo0BAZhCi
846
# Yz61wt3Ud8e//zhXWCkCsSV+IZCxxPzhEFd+RFVjW0Nm9hsb2FgAhkXCjsGROgoleYgaZJWvQaAg
847
# UyBzMmKDPKTllBHyE3Gy1ehBNGPgEBChf17/9M+j8pcm1OmlM434ctWQ4qW7RU56//yq1soFY0Te
848
# fu2ei03a6m68fYuW6s7XEEK58QisJWRAvEbpwu/eyqfs7PsQ+zSgJHyk2rO95IxdMtEESb2GRuoi
849
# Bs+AHNdYFTAi+GBWw9dvEgqQ0Mpv0//6bBE/Fb4d7b7f56uUNnnE7mFnjGmGQN+MvC62pfwfvJTT
850
# EkT1iZ9kjM9FprTFWXT4UmO3XTvesGeE50sV9YPm71X4DCQwc4KE8vyuwj0s6oMNAUACW2ClU9QQ
851
# y0tRpaF1tzs4N42Q5zl0TzWxbCCjAtC3u6xf+c8MCGrr7DzNhm42LOQiHTa4MwX4x96q7235oiAU
852
# iQqSI/hyF5yLpWw4etyUvsx2/0/0wkuTU1FozbLoCWJEWcPS7QadMrRRISxHf0YobIeQyz34regl
853
# t1qSQ3dCU9D6AHLgX6kqllx4X0fnFq7LtfN7fA2itW26v+kAT2QFZ3qZhINGfofCja/pITC1uNAZ
854
# gsJaTMcQ600krj/ynoxnjT+n1gmeqThac6/Mi3YlVeRtaxI2InL82ZuD+w/dfY9OpPssQjy3xiQa
855
# jPuaMWXRxz/sS9syOoGVH7XBwKrWpQcpchozWJt40QV5DslJkclcr8aC2AGlzuJMTdEgz1eqV0+H
856
# bAXG9HRHN/0eJTn1/QAAAAEABVguNTA5AAADjzCCA4swggJzAhRGqVxH4HTLYPGO4rzHcCPeGDKn
857
# xTANBgkqhkiG9w0BAQsFADCBgTELMAkGA1UEBhMCY2ExEDAOBgNVBAgMB29udGFyaW8xEDAOBgNV
858
# BAcMB3Rvcm9udG8xFDASBgNVBAoMC2plbmtpbnN0ZXN0MRkwFwYDVQQDDBBqZW5raW5zdGVzdC5p
859
# bmZvMR0wGwYJKoZIhvcNAQkBFg50ZXN0QHRlc3QuaW5mbzAeFw0xOTEwMDgxNTI5NTVaFw0xOTEx
860
# MDcxNTI5NTVaMIGBMQswCQYDVQQGEwJjYTEQMA4GA1UECAwHb250YXJpbzEQMA4GA1UEBwwHdG9y
861
# b250bzEUMBIGA1UECgwLamVua2luc3Rlc3QxGTAXBgNVBAMMEGplbmtpbnN0ZXN0LmluZm8xHTAb
862
# BgkqhkiG9w0BCQEWDnRlc3RAdGVzdC5pbmZvMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
863
# AQEA02q352JTHGvROMBhSHvSv+vnoOTDKSTz2aLQn0tYrIRqRo+8bfmMjXuhkwZPSnCpvUGNAJ+w
864
# Jrt/dqMoYUjCBkjylD/qHmnXN5EwS1cMg1Djh65gi5JJLFJ7eNcoSsr/0AJ+TweIal1jJSP3t3PF
865
# 9Uv21gm6xdm7HnNK66WpUUXLDTKaIs/jtagVY1bLOo9oEVeLN4nT2CYWztpMvdCyEDUzgEdDbmrP
866
# F5nKUPK5hrFqo1Dc5rUI4ZshL3Lpv398aMxv6n2adQvuL++URMEbXXBhxOrT6rCtYzbcR5fkwS9i
867
# d3Br45CoWOQro02JAepoU0MQKY5+xQ4Bq9Q7tB9BAwIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQAe
868
# 4xc+mSvKkrKBHg9/zpkWgZUiOp4ENJCi8H4tea/PCM439v6y/kfjT/okOokFvX8N5aa1OSz2Vsrl
869
# m8kjIc6hiA7bKzT6lb0EyjUShFFZ5jmGVP4S7/hviDvgB5yEQxOPpumkdRP513YnEGj/o9Pazi5h
870
# /MwpRxxazoda9r45kqQpyG+XoM4pB+Fd3JzMc4FUGxfVPxJU4jLawnJJiZ3vqiSyaB0YyUL+Er1Q
871
# 6NnqtR4gEBF0ZVlQmkycFvD4EC2boP943dLqNUvop+4R3SM1QMM6P5u8iTXtHd/VN4MwMyy1wtog
872
# hYAzODo1Jt59pcqqKJEas0C/lFJEB3frw4ImNx5fNlJYOpx+ijfQs9m39CevDq0=
873
874
agent:
875
# -- Add the environment proxy settings form jenkins controller to the agents.
876
addMasterProxyEnvVars: false
877
# -- Enable Kubernetes plugin jnlp-agent podTemplate
878
enabled: true
879
# -- The name of the pod template to use for providing default values
880
defaultsProviderTemplate: ""
881
# Useful for not including a serviceAccount in the template if `false`
882
# -- Use `serviceAccountAgent.name` as the default value for defaults template `serviceAccount`
883
useDefaultServiceAccount: true
884
# -- Override the default service account
885
# @default -- `serviceAccountAgent.name` if `agent.useDefaultServiceAccount` is `true`
886
serviceAccount:
887
# For connecting to the Jenkins controller
888
# -- Overrides the Kubernetes Jenkins URL
889
jenkinsUrl:
890
# connects to the specified host and port, instead of connecting directly to the Jenkins controller
891
# -- Overrides the Kubernetes Jenkins tunnel
892
jenkinsTunnel:
893
# -- Disables the verification of the controller certificate on remote connection. This flag correspond to the "Disable https certificate check" flag in kubernetes plugin UI
894
skipTlsVerify: false
895
# -- Enable the possibility to restrict the usage of this agent to specific folder. This flag correspond to the "Restrict pipeline support to authorized folders" flag in kubernetes plugin UI
896
usageRestricted: false
897
# -- The connection timeout in seconds for connections to Kubernetes API. The minimum value is 5
898
kubernetesConnectTimeout: 5
899
# -- The read timeout in seconds for connections to Kubernetes API. The minimum value is 15
900
kubernetesReadTimeout: 15
901
# -- The maximum concurrent connections to Kubernetes API
902
maxRequestsPerHostStr: "32"
903
# -- Time in minutes after which the Kubernetes cloud plugin will clean up an idle worker that has not already terminated
904
retentionTimeout: 5
905
# -- Seconds to wait for pod to be running
906
waitForPodSec: 600
907
# -- Namespace in which the Kubernetes agents should be launched
908
namespace:
909
# -- Custom Pod labels (an object with `label-key: label-value` pairs)
910
podLabels: {}
911
# -- Custom registry used to pull the agent jnlp image from
912
jnlpregistry:
913
image:
914
# -- Registry to pull the agent jnlp image from
915
registry: cgr.dev
916
# -- Repository to pull the agent jnlp image from
917
repository: chainguard-private/jenkins-inbound-agent
918
# -- Tag of the image to pull
919
tag: 2.588-r0-jdk21@sha256:60db9a4d39d2826a691a850814e0ec72a1643ebbd7afb8a1ae1c565f9ac42d53
920
# -- Configure working directory for default agent
921
workingDir: "/home/jenkins/agent"
922
nodeUsageMode: "NORMAL"
923
# -- Append Jenkins labels to the agent
924
customJenkinsLabels: []
925
# -- Name of the secret to be used to pull the image
926
imagePullSecretName:
927
componentName: "jenkins-agent"
928
# -- Enables agent communication via websockets
929
websocket: false
930
directConnection: false
931
# -- Agent privileged container
932
privileged: false
933
# -- Configure container user
934
runAsUser:
935
# -- Configure container group
936
runAsGroup:
937
# -- Enables the agent to use the host network
938
hostNetworking: false
939
# -- Resources allocation (Requests and Limits)
940
resources:
941
requests:
942
cpu: "512m"
943
memory: "512Mi"
944
# ephemeralStorage:
945
limits:
946
cpu: "512m"
947
memory: "512Mi"
948
# ephemeralStorage:
949
livenessProbe: {}
950
# execArgs: "cat /tmp/healthy"
951
# failureThreshold: 3
952
# initialDelaySeconds: 0
953
# periodSeconds: 10
954
# successThreshold: 1
955
# timeoutSeconds: 1
956
957
# You may want to change this to true while testing a new image
958
# -- Always pull agent container image before build
959
alwaysPullImage: false
960
# When using Pod Security Admission in the Agents namespace with the restricted Pod Security Standard,
961
# the jnlp container cannot be scheduled without overriding its container definition with a securityContext.
962
# This option allows to automatically inject in the jnlp container a securityContext
963
# that is suitable for the use of the restricted Pod Security Standard.
964
# -- Set a restricted securityContext on jnlp containers
965
restrictedPssSecurityContext: false
966
# Controls how agent pods are retained after the Jenkins build completes
967
# Possible values: Always, Never, OnFailure
968
podRetention: "Never"
969
# Disable if you do not want the Yaml the agent pod template to show up
970
# in the job Console Output. This can be helpful for either security reasons
971
# or simply to clean up the output to make it easier to read.
972
showRawYaml: true
973
# You can define the volumes that you want to mount for this container
974
# Allowed types are: ConfigMap, EmptyDir, EphemeralVolume, HostPath, Nfs, PVC, Secret
975
# Configure the attributes as they appear in the corresponding Java class for that type
976
# https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/main/java/org/csanchez/jenkins/plugins/kubernetes/volumes
977
# -- Additional volumes
978
volumes: []
979
# - type: ConfigMap
980
# configMapName: myconfigmap
981
# mountPath: /var/myapp/myconfigmap
982
# - type: EmptyDir
983
# mountPath: /var/myapp/myemptydir
984
# memory: false
985
# - type: EphemeralVolume
986
# mountPath: /var/myapp/myephemeralvolume
987
# accessModes: ReadWriteOnce
988
# requestsSize: 10Gi
989
# storageClassName: mystorageclass
990
# - type: HostPath
991
# hostPath: /var/lib/containers
992
# mountPath: /var/myapp/myhostpath
993
# - type: Nfs
994
# mountPath: /var/myapp/mynfs
995
# readOnly: false
996
# serverAddress: "192.0.2.0"
997
# serverPath: /var/lib/containers
998
# - type: PVC
999
# claimName: mypvc
1000
# mountPath: /var/myapp/mypvc
1001
# readOnly: false
1002
# - type: Secret
1003
# defaultMode: "600"
1004
# mountPath: /var/myapp/mysecret
1005
# secretName: mysecret
1006
# Pod-wide environment, these vars are visible to any container in the agent pod
1007
1008
# You can define the workspaceVolume that you want to mount for this container
1009
# Allowed types are: DynamicPVC, EmptyDir, EphemeralVolume, HostPath, Nfs, PVC
1010
# Configure the attributes as they appear in the corresponding Java class for that type
1011
# https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/main/java/org/csanchez/jenkins/plugins/kubernetes/volumes/workspace
1012
# -- Workspace volume (defaults to EmptyDir)
1013
workspaceVolume: {}
1014
## DynamicPVC example
1015
# - type: DynamicPVC
1016
# configMapName: myconfigmap
1017
## EmptyDir example
1018
# - type: EmptyDir
1019
# memory: false
1020
## EphemeralVolume example
1021
# - type: EphemeralVolume
1022
# accessModes: ReadWriteOnce
1023
# requestsSize: 10Gi
1024
# storageClassName: mystorageclass
1025
## HostPath example
1026
# - type: HostPath
1027
# hostPath: /var/lib/containers
1028
## NFS example
1029
# - type: Nfs
1030
# readOnly: false
1031
# serverAddress: "192.0.2.0"
1032
# serverPath: /var/lib/containers
1033
## PVC example
1034
# - type: PVC
1035
# claimName: mypvc
1036
# readOnly: false
1037
1038
# Pod-wide environment, these vars are visible to any container in the agent pod
1039
# -- Environment variables for the agent Pod
1040
envVars: []
1041
# - name: PATH
1042
# value: /usr/local/bin
1043
# -- Mount a secret as environment variable
1044
secretEnvVars: []
1045
# - key: PATH
1046
# optional: false # default: false
1047
# secretKey: MY-K8S-PATH
1048
# secretName: my-k8s-secret
1049
1050
# -- Node labels for pod assignment
1051
nodeSelector: {}
1052
# Key Value selectors. Ex:
1053
# nodeSelector
1054
# jenkins-agent: v1
1055
1056
# -- Command to execute when side container starts
1057
command:
1058
# -- Arguments passed to command to execute
1059
args: "${computer.jnlpmac} ${computer.name}"
1060
# -- Side container name
1061
sideContainerName: "jnlp"
1062
# Doesn't allocate pseudo TTY by default
1063
# -- Allocate pseudo tty to the side container
1064
TTYEnabled: false
1065
# -- Max number of agents to launch for a whole cluster.
1066
containerCap: 10
1067
# -- Max number of agents to launch for this type of agent
1068
instanceCap: 2147483647
1069
# -- Agent Pod base name
1070
podName: "default"
1071
# Enables garbage collection of orphan pods for this Kubernetes cloud. (beta)
1072
garbageCollection:
1073
# -- When enabled, Jenkins will periodically check for orphan pods that have not been touched for the given timeout period and delete them.
1074
enabled: false
1075
# -- Namespaces to look at for garbage collection, in addition to the default namespace defined for the cloud. One namespace per line.
1076
namespaces: ""
1077
# namespaces: |-
1078
# namespaceOne
1079
# namespaceTwo
1080
# -- Timeout value for orphaned pods
1081
timeout: 300
1082
# -- Allows the Pod to remain active for reuse until the configured number of minutes has passed since the last step was executed on it
1083
idleMinutes: 0
1084
# The raw yaml of a Pod API Object, for example, this allows usage of toleration for agent pods.
1085
# https://github.com/jenkinsci/kubernetes-plugin#using-yaml-to-define-pod-templates
1086
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
1087
# -- The raw yaml of a Pod API Object to merge into the agent spec
1088
yamlTemplate: ""
1089
# yamlTemplate: |-
1090
# apiVersion: v1
1091
# kind: Pod
1092
# spec:
1093
# tolerations:
1094
# - key: "key"
1095
# operator: "Equal"
1096
# value: "value"
1097
1098
# -- Defines how the raw yaml field gets merged with yaml definitions from inherited pod templates. Possible values: "merge" or "override"
1099
yamlMergeStrategy: "override"
1100
# -- Controls whether the defined yaml merge strategy will be inherited if another defined pod template is configured to inherit from the current one
1101
inheritYamlMergeStrategy: false
1102
# -- Timeout in seconds for an agent to be online
1103
connectTimeout: 100
1104
# -- Annotations to apply to the pod
1105
annotations: {}
1106
# Containers specified here are added to all agents. Set key empty to remove container from additional agents.
1107
# -- Add additional containers to the agents
1108
additionalContainers: []
1109
# - sideContainerName: dind
1110
# image:
1111
# repository: docker
1112
# tag: dind
1113
# command: dockerd-entrypoint.sh
1114
# args: ""
1115
# privileged: true
1116
# resources:
1117
# requests:
1118
# cpu: 500m
1119
# memory: 1Gi
1120
# limits:
1121
# cpu: 1
1122
# memory: 2Gi
1123
1124
# Useful when configuring agents only with the podTemplates value, since the default podTemplate populated by values mentioned above will be excluded in the rendered template.
1125
# -- Disable the default Jenkins Agent configuration
1126
disableDefaultAgent: false
1127
# Below is the implementation of custom pod templates for the default configured kubernetes cloud.
1128
# Add a key under podTemplates for each pod template. Each key (prior to | character) is just a label, and can be any value.
1129
# Keys are only used to give the pod template a meaningful name. The only restriction is they may only contain RFC 1123 \ DNS label
1130
# characters: lowercase letters, numbers, and hyphens. Each pod template can contain multiple containers.
1131
# For this pod templates configuration to be loaded, the following values must be set:
1132
# controller.JCasC.defaultConfig: true
1133
# Best reference is https://<jenkins_url>/configuration-as-code/reference#Cloud-kubernetes. The example below creates a python pod template.
1134
# -- Configures extra pod templates for the default kubernetes cloud
1135
podTemplates: {}
1136
# python: |
1137
# - name: python
1138
# label: jenkins-python
1139
# serviceAccount: jenkins
1140
# containers:
1141
# - name: python
1142
# image: python:3
1143
# command: "/bin/sh -c"
1144
# args: "cat"
1145
# ttyEnabled: true
1146
# privileged: true
1147
# resourceRequestCpu: "400m"
1148
# resourceRequestMemory: "512Mi"
1149
# resourceLimitCpu: "1"
1150
# resourceLimitMemory: "1024Mi"
1151
# Inherits all values from `agent` so you only need to specify values which differ
1152
# -- Configure additional
1153
additionalAgents: {}
1154
# maven:
1155
# podName: maven
1156
# customJenkinsLabels: maven
1157
# # An example of overriding the jnlp container
1158
# # sideContainerName: jnlp
1159
# image:
1160
# repository: jenkins/jnlp-agent-maven
1161
# tag: latest
1162
# python:
1163
# podName: python
1164
# customJenkinsLabels: python
1165
# sideContainerName: python
1166
# image:
1167
# repository: python
1168
# tag: "3"
1169
# command: "/bin/sh -c"
1170
# args: "cat"
1171
# TTYEnabled: true
1172
1173
# Here you can add additional clouds
1174
# They inherit all values from the default cloud (including the main agent), so
1175
# you only need to specify values which differ. If you want to override
1176
# default additionalAgents with the additionalClouds.additionalAgents set
1177
# additionalAgentsOverride to `true`.
1178
# To override inherited cloud traits, set controller.cloudTraits for that cloud (use [] to clear them).
1179
additionalClouds: {}
1180
# remote-cloud-1:
1181
# kubernetesURL: https://api.remote-cloud.com
1182
# controller:
1183
# cloudTraits:
1184
# - ephemeralContainer
1185
# additionalAgentsOverride: true
1186
# additionalAgents:
1187
# maven-2:
1188
# podName: maven-2
1189
# customJenkinsLabels: maven
1190
# # An example of overriding the jnlp container
1191
# # sideContainerName: jnlp
1192
# image:
1193
# repository: jenkins/jnlp-agent-maven
1194
# tag: latest
1195
# namespace: my-other-maven-namespace
1196
# remote-cloud-2:
1197
# kubernetesURL: https://api.remote-cloud.com
1198
1199
persistence:
1200
# -- Enable the use of a Jenkins PVC
1201
enabled: true
1202
# A manually managed Persistent Volume and Claim
1203
# Requires persistence.enabled: true
1204
# If defined, PVC must be created manually before volume will be bound
1205
# -- Provide the name of a PVC
1206
existingClaim:
1207
# jenkins data Persistent Volume Storage Class
1208
# If defined, storageClassName: <storageClass>
1209
# If set to "-", storageClassName: "", which disables dynamic provisioning
1210
# If undefined (the default) or set to null, no storageClassName spec is
1211
# set, choosing the default provisioner (gp2 on AWS, standard on GKE, AWS & OpenStack)
1212
# -- Storage class for the PVC
1213
storageClass:
1214
# -- Annotations for the PVC
1215
annotations: {}
1216
# -- Labels for the PVC
1217
labels: {}
1218
# -- The PVC access mode
1219
accessMode: "ReadWriteOnce"
1220
# -- The size of the PVC
1221
size: "8Gi"
1222
# ref: https://kubernetes.io/docs/concepts/storage/volume-pvc-datasource/
1223
# -- Existing data source to clone PVC from
1224
dataSource: {}
1225
# name: PVC-NAME
1226
# kind: PersistentVolumeClaim
1227
1228
# -- SubPath for jenkins-home mount
1229
subPath:
1230
# -- Additional volumes
1231
volumes: []
1232
# - name: nothing
1233
# emptyDir: {}
1234
1235
# -- Additional mounts
1236
mounts: []
1237
# - mountPath: /var/nothing
1238
# name: nothing
1239
# readOnly: true
1240
networkPolicy:
1241
# -- Enable the creation of NetworkPolicy resources
1242
enabled: false
1243
# For Kubernetes v1.4, v1.5 and v1.6, use 'extensions/v1beta1'
1244
# For Kubernetes v1.7, use 'networking.k8s.io/v1'
1245
# -- NetworkPolicy ApiVersion
1246
apiVersion: networking.k8s.io/v1
1247
# You can allow agents to connect from both within the cluster (from within specific/all namespaces) AND/OR from a given external IP range
1248
internalAgents:
1249
# -- Allow internal agents (from the same cluster) to connect to controller. Agent pods will be filtered based on PodLabels
1250
allowed: true
1251
# -- A map of labels (keys/values) that agent pods must have to be able to connect to controller
1252
podLabels: {}
1253
# -- A map of labels (keys/values) that agents namespaces must have to be able to connect to controller
1254
namespaceLabels: {}
1255
# project: myproject
1256
externalAgents:
1257
# -- The IP range from which external agents are allowed to connect to controller, i.e., 172.17.0.0/16
1258
ipCIDR:
1259
# -- A list of IP sub-ranges to be excluded from the allowlisted IP range
1260
except: []
1261
# - 172.17.1.0/24
1262
## Install Default RBAC roles and bindings
1263
rbac:
1264
# -- Whether RBAC resources are created
1265
create: true
1266
# -- Whether the Jenkins service account should be able to read Kubernetes secrets
1267
readSecrets: false
1268
# -- Whether the Jenkins service account should be able to use the OpenShift "nonroot" Security Context Constraints
1269
useOpenShiftNonRootSCC: false
1270
serviceAccount:
1271
# -- Configures if a ServiceAccount with this name should be created
1272
create: true
1273
# The name of the ServiceAccount is autogenerated by default
1274
# -- The name of the ServiceAccount to be used by access-controlled resources
1275
name:
1276
# -- Configures annotations for the ServiceAccount
1277
annotations: {}
1278
# -- Configures extra labels for the ServiceAccount
1279
extraLabels: {}
1280
# -- Controller ServiceAccount image pull secret
1281
imagePullSecretName:
1282
# -- Auto-mount ServiceAccount token
1283
automountServiceAccountToken: true
1284
serviceAccountAgent:
1285
# -- Configures if an agent ServiceAccount should be created
1286
create: false
1287
# If not set and create is true, a name is generated using the fullname template
1288
# -- The name of the agent ServiceAccount to be used by access-controlled resources
1289
name:
1290
# -- Configures annotations for the agent ServiceAccount
1291
annotations: {}
1292
# -- Configures extra labels for the agent ServiceAccount
1293
extraLabels: {}
1294
# -- Agent ServiceAccount image pull secret
1295
imagePullSecretName:
1296
# -- Auto-mount ServiceAccount token
1297
automountServiceAccountToken: true
1298
# -- Checks if any deprecated values are used
1299
checkDeprecation: true
1300
awsSecurityGroupPolicies:
1301
enabled: false
1302
policies:
1303
- name: ""
1304
securityGroupIds: []
1305
podSelector: {}
1306
# Here you can configure unit tests values when executing the helm unittest in the CONTRIBUTING.md
1307
helmtest:
1308
# A testing framework for bash
1309
bats:
1310
# Bash Automated Testing System (BATS)
1311
# -- Name of the secret to be used to pull the image
1312
imagePullSecretName: ""
1313
image:
1314
# -- Registry of the image used to test the framework
1315
registry: "docker.io"
1316
# -- Repository of the image used to test the framework
1317
repository: "bats/bats"
1318
# -- Tag of the image to test the framework
1319
tag: "1.14.0"
1320

The trusted source for open source

Talk to an expert
PrivacyTerms

Product

Chainguard ContainersChainguard LibrariesChainguard VMsChainguard OS PackagesChainguard ActionsChainguard Agent SkillsIntegrationsPricing
© 2026 Chainguard, Inc. All Rights Reserved.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.