Skip to main content

cdk8s-jenkins

cdk8s-jenkins is a library that lets you easily define a manifest for deploying a Jenkins instance to your Kubernetes cluster.

Prerequisites

This library uses a Custom Resource Definition provided by jenkins, and thus requires both the CRD and the operator to be installed on the cluster. You can set this up by,

  1. Apply the Custom Resource Definition(CRD) for jenkins on your Kubernetes cluster.
kubectl apply -f https://raw.githubusercontent.com/jenkinsci/kubernetes-operator/master/config/crd/bases/jenkins.io_jenkins.yaml
  1. Install the Jenkins Operator on your Kubernetes cluster.
kubectl apply -f https://raw.githubusercontent.com/jenkinsci/kubernetes-operator/master/deploy/all-in-one-v1alpha2.yaml

For more information regarding applying jenkins crd and installing jenkins operator, please refer jenkins official documentaion.

Usage

The library provides a high level Jenkins construct to provision a Jenkins instance. You can just instantiate the Jenkins instance and that would add a Jenkins resource to the kubernetes manifest.

The library provide a set of defaults, so provisioning a basic Jenkins instance requires no configuration:

import { Jenkins } from 'cdk8s-jenkins';

// inside your chart:
const jenkins = new Jenkins(this, 'my-jenkins');

The library also enables configuring the following parmeters for the Jenkins instance:

metadata

const jenkins = new Jenkins(this, 'my-jenkins', {
  metadata: {
    namespace: 'jenkins-namespace',
    labels: { customApp: 'my-jenkins' },
  },
});

disableCsrfProtection

This allows you to toggle CSRF Protection for Jenkins.

const jenkins = new Jenkins(this, 'my-jenkins', {
  disableCsrfProtection: true,
});

basePlugins

These are the plugins required by the jenkins operator.

const jenkins = new Jenkins(this, 'my-jenkins', {
  basePlugins: [{
    name: 'configuration-as-code',
    version: '1.55',
    }],
});

You can also utilize addBasePlugins function to add base plugins to jenkins configuration after initialization.

const jenkins = new Jenkins(this, 'my-jenkins');
jenkins.addBasePlugins([{
  name: 'workflow-api',
  version: '2.76',
}]);

plugins

These are the plugins that you can add to your jenkins instance.

const jenkins = new Jenkins(this, 'my-jenkins', {
  plugins: [{
    name: 'simple-theme-plugin',
    version: '0.7',
    }],
});

You can also utilize addPlugins function to add plugins to jenkins configuration after initialization.

const jenkins = new Jenkins(this, 'my-jenkins');
jenkins.addPlugins([{
  name: 'simple-theme-plugin',
  version: '0.7',
}]);

seedJobs

You can define list of jenkins seed job configurations here. For more info you can take look at jenkins documentation.

const jenkins = new Jenkins(this, 'my-jenkins', {
  seedJobs: [{
    id: 'jenkins-operator',
    targets: 'cicd/jobs/*.jenkins',
    description: 'Jenkins Operator repository',
    repositoryBranch: 'master',
    repositoryUrl: 'https://github.com/jenkinsci/kubernetes-operator.git',
    }],
});

You can also utilize addSeedJobs function to add seed jobs to jenkins configuration after initialization.

const jenkins = new Jenkins(this, 'my-jenkins');
jenkins.addSeedJobs([{
  id: 'jenkins-operator',
  targets: 'cicd/jobs/*.jenkins',
  description: 'Jenkins Operator repository',
  repositoryBranch: 'master',
  repositoryUrl: 'https://github.com/jenkinsci/kubernetes-operator.git',
}]);

Using escape hatches

You can utilize escape hatches to make changes to the configurations that are not yet exposed by the library.

For instance, if you would like to update the version of a base plugin:

const jenkins = new Jenkins(this, 'my-jenkins');
const jenkinsApiObject = ApiObject.of(jenkins);
jenkinsApiObject.addJsonPatch(JsonPatch.replace('/spec/master/basePlugins/1', {
  name: 'workflow-job',
  version: '3.00',
}));

For more information regarding escape hatches, take a look at cdk8s documentation.

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

Metadata

Release files for cdk8s-jenkins 0.0.631

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cdk8s-jenkins 0.0.631
File Size Uploaded Provenance Actions
cdk8s_jenkins-0.0.631.tar.gz 158.9 kB With provenance Details for cdk8s_jenkins-0.0.631.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cdk8s-jenkins 0.0.631
File Interpreter ABI Platform Actions
cdk8s_jenkins-0.0.631-py3-none-any.whl Python 3 none any Details for cdk8s_jenkins-0.0.631-py3-none-any.whl

Total release size: 315.8 kB

Release files / cdk8s_jenkins-0.0.631.tar.gz

Download URL cdk8s_jenkins-0.0.631.tar.gz
Size 158.9 kB
Tags Source
SHA-256 checksum
How to use checksums
d97925986a5c8041a5740a583657604dfd24a4a4d1a6804a63e0f28373ef9903
BLAKE2b-256 checksum
How to use checksums
21c217fdf8be03d6677d8c76ceefa6b2ae3aed3e3e3f7ba1ac0c47b592045d79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.15.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / cdk8s_jenkins-0.0.631-py3-none-any.whl

Download URL cdk8s_jenkins-0.0.631-py3-none-any.whl
Size 156.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a99e02da7f3d53bed6dfd67251aeb61f7adaea7820d24eb3e6c298f8b614f55a
BLAKE2b-256 checksum
How to use checksums
51e8b8b7856214482f082ac27d54f331b68c6bfdebaee7e291875ca8904399f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.15.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for cdk8s-jenkins 0.0.631

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cdk8s_jenkins-0.0.631.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.631 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page