Scheme

Spec defines the desired state of the Jenkins

Status defines the observed state of Jenkins

ContainerName is the container name responsible for backup operation

Action defines the action which performs the backup in the backup container sidecar

Interval tells you how often the backup is made in seconds Defaults to 30.

MakeBackupBeforePodDeletion tells the operator to make a backup before Jenkins master pod deletion

JobName is the Jenkins job name

Hash is the unique data identifier used in build

Number is the Jenkins build number

Status is the status of a Jenkins build

Retires is the amount of times a Jenkins job build retries

CreateTime is the time when the first build has been created

LastUpdateTime is the last update status time

Name of the container specified as a DNS_LABEL. Each container in a pod must have a unique name (DNS_LABEL).

Docker image name. More info: https://kubernetes.io/docs/concepts/containers/images

Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always.

Compute Resources required by this container. More info: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

Entrypoint array. Not executed within a shell. The docker image’s ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container’s environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

Arguments to the entrypoint. The docker image’s CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container’s environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

Container’s working directory. If not specified, the container runtime’s default will be used, which might be configured in the container image.

List of ports to expose from the container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default “0.0.0.0” address inside a container will be accessible from the network.

List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence.

List of environment variables to set in the container.

Pod volumes to mount into the container’s filesystem.

Periodic probe of container liveness. The container will be restarted if the probe fails.

Periodic probe of container service readiness. The container will be removed from service endpoints if the probe fails.

Actions that the management system should take in response to container lifecycle events.

Security options the pod should run with. More info: https://kubernetes.io/docs/concepts/policy/security-context/ More info: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/

Exec specifies the action to take.

Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations

NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node’s labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

SecurityContext that applies to all the containers of the Jenkins Master. As per kubernetes specification, it can be overridden for each container individually. Defaults to: runAsUser: 1000 fsGroup: 1000

List of containers belonging to the pod. Containers cannot currently be added or removed. There must be at least one container in a Pod. Defaults to: - image: jenkins/jenkins:lts imagePullPolicy: Always livenessProbe: failureThreshold: 12 httpGet: path: /login port: http scheme: HTTP initialDelaySeconds: 80 periodSeconds: 10 successThreshold: 1 timeoutSeconds: 5 name: jenkins-master readinessProbe: failureThreshold: 3 httpGet: path: /login port: http scheme: HTTP initialDelaySeconds: 30 periodSeconds: 10 successThreshold: 1 timeoutSeconds: 1 resources: limits: cpu: 1500m memory: 3Gi requests: cpu: “1” memory: 600Mi

List of volumes that can be mounted by containers belonging to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes

BasePlugins contains plugins required by operator Defaults to : - name: kubernetes version: 1.15.7 - name: workflow-job version: “2.32” - name: workflow-aggregator version: “2.6” - name: git version: 3.10.0 - name: job-dsl version: “1.74” - name: configuration-as-code version: “1.19” - name: kubernetes-credentials-provider version: 0.12.1

Plugins contains plugins required by user

Master represents the Jenkins master pod properties and Jenkins plugins. Every single change here requires a pod restart.

SeedJobs defines list of Jenkins Seed Job configurations More info: https://github.com/jenkinsci/kubernetes-operator/blob/master/docs/getting-started.md#configure-seed-jobs-and-pipelines

Service is the Kubernetes service of the Jenkins master HTTP pod Defaults to : port: 8080 type: ClusterIP

Service is the Kubernetes service of the Jenkins slave pods Defaults to : port: 50000 type: ClusterIP

Backup defines the configuration of the Jenkins backup More info: https://github.com/jenkinsci/kubernetes-operator/blob/master/docs/getting-started.md#configure-backup-and-restore

Backup defines the configuration of the Jenkins backup restore More info: https://github.com/jenkinsci/kubernetes-operator/blob/master/docs/getting-started.md#configure-backup-and-restore

OperatorVersion is the operator version which manages this CR

ProvisionStartTime is a time when the Jenkins master pod has been created

BaseConfigurationCompletedTime is a time when Jenkins base configuration phase has been completed

UserConfigurationCompletedTime is a time when Jenkins user configuration phase has been completed

Builds contains the Jenkins builds statues

RestoredBackup is the restored backup number after the Jenkins master pod restart

LastBackup is the latest backup number

PendingBackup is the pending backup number

BackupDoneBeforePodDeletion tells if a backup before pod deletion has been made

UserAndPasswordHash is a SHA256 hash made from the username and password

CreatedSeedJobs contains list of seed job ids already created in Jenkins

Name is the name of the Jenkins plugin

Version is the version of the Jenkins plugin

ContainerName is the container name responsible for the restore backup operation

Action defines action which performs the restore backup in a restore container sidecar

RecoveryOnce if you want to restore a specific backup, set this field, and then Jenkins will be restarted and the desired backup will be restored

ID is the unique seed job name

CredentialID is the Kubernetes secret name which stores repository access credentials

Description is the description of the seed job

Targets is the repository path where the seed job definitions are

RepositoryBranch is the repository branch where the seed job definitions are

RepositoryURL is the repository access URL. Can be SSH or HTTPS.

JenkinsCredentialType is the https://jenkinsci.github.io/kubernetes-credentials-provider-plugin/ credential type

Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations

Route service traffic to pods with label keys and values matching this selector. If empty or not present, the service is assumed to have an external process managing its endpoints, which Kubernetes will not modify. Only applies to types ClusterIP, NodePort, and LoadBalancer. Ignored if type is ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/

Type determines how the Service is exposed. Defaults to ClusterIP. Valid options are ExternalName, ClusterIP, NodePort, and LoadBalancer. “ExternalName” maps to the specified externalName. “ClusterIP” allocates a cluster-internal IP address for load-balancing to endpoints. Endpoints are determined by the selector or if that is not specified, by manual construction of an Endpoints object. If clusterIP is “None”, no virtual IP is allocated and the endpoints are published as a set of endpoints rather than a stable IP. “NodePort” builds on ClusterIP and allocates a port on every node which routes to the clusterIP. “LoadBalancer” builds on NodePort and creates an external load-balancer (if supported in the current cloud) which routes to the clusterIP. More info: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services—service-types

The port that is exposed by this service. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

The port on each node on which this service is exposed when type=NodePort or LoadBalancer. Usually assigned by the system. If specified, it will be allocated to the service, if unused, or else creation of the service will fail. Default is to auto-allocate a port if the ServiceType of this Service requires one. More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport

If specified and supported by the platform, this will restrict traffic through the cloud-provider. The load-balancer will be restricted to the specified client IPs. This field will be ignored if the cloud-provider does not support the feature.” More info: https://kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/

Only applies to Service Type: LoadBalancer LoadBalancer will get created with the IP specified in this field. This feature depends on whether the underlying cloud-provider supports specifying the loadBalancerIP when a load balancer is created. This field will be ignored if the cloud-provider does not support the feature.