Supported platforms for CloudBees CI on modern cloud platforms

When running CloudBees CI on modern cloud platforms, consult this page for supported platforms.

Supported Kubernetes

CloudBees supports running CloudBees CI on modern cloud platforms on:

Kubernetes reference platforms
- Amazon Elastic Kubernetes Service (EKS)
- Azure Kubernetes Service (AKS)
- Google Kubernetes Engine (GKE)
- VMware Tanzu Kubernetes Grid Integrated Edition (TKGI)
- Red Hat OpenShift Container Platform (OCP) 3.11
- Red Hat OpenShift Container Platform (OCP) 4.2, starting with CloudBees CI on modern cloud platforms version 2.204.1.3
- Red Hat OpenShift Container Platform (OCP) 4.3-4.6, starting with CloudBees CI on modern cloud platforms version 2.204.3.4
- Red Hat OpenShift Container Platform (OCP) 4.7, starting with CloudBees CI on modern cloud platforms version 2.263.4.2
CNCF-certified Kubernetes, versions 1.14 through 1.20. See Certified Kubernetes for information about CNCF-certified Kubernetes.

The following criteria are required for the above supported Kubernetes platforms:

The version is Generally Available.

CloudBees does not support or recommend "proof of concept" offerings of Kubernetes platforms or Beta or Public preview versions.
The version is actively supported by the Kubernetes distribution provider.

Supported Helm

CloudBees supports only production releases of Helm: RC, beta, patch or experimental releases of Helm are not supported.

Starting with CloudBees CI on modern cloud platforms version 2.204.3.4, Helm version 3.0.2 or later is supported.

We recommend that you migrate to Helm V3 as soon as possible. Support of Helm V2 was deprecated in July 2020.

Microsoft Windows container support

As of CloudBees CI on modern cloud platforms version 2.190.3.2, CloudBees CI on modern cloud platforms supports Microsoft Windows containers for Kubernetes 1.x starting with version 1.14. However, you can only run CloudBees CI on modern cloud platforms agents in Windows containers. Running controllers or the operations center on Microsoft Windows containers in Kubernetes is not supported. Each cloud provider has various levels of support for Kubernetes features, including Windows containers, so confirm the status with your cloud platform provider.

As of CloudBees CI on modern cloud platforms version 2.263.4.1, Microsoft Windows LTSC 2019 (version 1809) is supported for agents running on Google Kubernetes Engine (GKE) clusters, but not for the operations center or controllers. If running Windows workloads with agents on a GKE cluster, the image provided by CloudBees CI on modern cloud platforms only works on version 1809 of Windows LTSC.

This feature is documented in Managing agents - Running CloudBees CI build agents in Windows containers.

Supported NFS versions

CloudBees supports the following versions of NFS:

NFS v.3.x
NFS v4.1 and higher

There are known performance issues with NFS v4.0. CloudBees supports NFS v4.1 and higher, but CloudBees does not support NFS v4.0.

Amazon Elastic File System (Amazon EFS) support

CloudBees supports Amazon EFS as a storage backend for CloudBees CI. However, like any technology, Amazon EFS comes with tradeoffs that should be explored and understood.

You can use EFS to create a volume available across multiple Availability Zones. However, this comes at the cost of both performance and a higher price. Due to EFS’s nature, it will almost always perform slower than EBS, which some will find unacceptable. For fine-tuning the EFS performance configuration, please refer to Amazon’s documentation: https://aws.amazon.com/premiumsupport/knowledge-center/linux-efs-performance-modes/.

Although rare, customers have encountered issues with the default settings (Burst Credits), resulting in a complete outage of the platform.

If you open a support case about a problem with CloudBees CI on Amazon EFS, we will work with you to ensure that the CloudBees CI product is working correctly. If we believe that the problem is due to the performance of Amazon EFS, we may ask you to open a support case with Amazon to resolve the issue. In some rare situations, the CloudBees CI product may be working as intended, and the CloudBees support ticket may be closed without resolution of the reported problem.

Configuration as Code (CasC) for Controllers support

Configuration as Code (CasC) for Controllers is supported in CloudBees CI on modern cloud platforms as of May 2020.

operations center cannot be configured as code within CloudBees CI on modern cloud platforms.
Role-Based Access Control is supported with the CloudBees CasC API Plugin, version 1.2 or later.

Tier 1 and Tier 2 plugins support for Configuration as Code

The following plugins support Configuration as Code (CasC).

If you don’t see a plugin in this list, this can mean one of two things: that plugin does not support CasC or that plugin does not require configuration.

This list of plugins applies to CloudBees CI, CloudBees Jenkins Distribution, and CloudBees Jenkins Platform.

Configuration as Code is not supported on CloudBees operations center.

Table 1. List of plugins in CloudBees Assurance Program supporting Configuration as Code
Plugin Name	Minimum version	Configuration example
active-directory	2.16	https://github.com/jenkinsci/active-directory-plugin/blob/5b9401f6213a5fe24ef4bb0009cf7d8b644ff483/src/test/resources/hudson/plugins/active_directory/configuration-as-code.yaml
ant	1.10	https://github.com/jenkinsci/ant-plugin/blob/master/src/test/resources/hudson/tasks/configuration-as-code.yaml
antisamy-markup-formatter	1.6	https://github.com/jenkinsci/antisamy-markup-formatter-plugin/blob/master/src/test/resources/hudson/markup/configuration-as-code.yaml
artifact-manager-s3	1.1	https://github.com/jenkinsci/artifact-manager-s3-plugin/blob/master/src/test/resources/io/jenkins/plugins/artifact_manager_jclouds/s3/configuration-as-code.yml
aws-credentials	1.28	https://github.com/jenkinsci/aws-credentials-plugin/blob/2ae45df5330d9e64a574979736def83fa8dece0f/src/test/resources/com/cloudbees/jenkins/plugins/awscredentials/configuration-as-code.yaml
aws-global-configuration	1.4	https://github.com/jenkinsci/aws-global-configuration-plugin/blob/80f300120402cdd3bb9303c365260f80ef351ac0/src/test/resources/io/jenkins/plugins/aws/global_configuration/configuration-as-code.yaml
cloudbees-assurance	2.138.0.13	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-assurance-plugin/configuration-as-code.yml
cloudbees-bitbucket-branch-source	2.4.0	https://github.com/jenkinsci/bitbucket-branch-source-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/bitbucket/endpoints/BitbucketEndpointConfigurationTest/configuration-as-code.yml
cloudbees-cloudfoundry-cli	2.1.6	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-cloudfoundry-api-plugin/configuration-as-code.yml
cloudbees-cyberark-credentials	1.0.5	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-cyberark-credentials-plugin/configuration-as-code.yml
cloudbees-even-scheduler	3.10	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-even-scheduler-plugin/configuration-as-code.yml
cloudbees-jenkins-advisor	3.0	https://github.com/jenkinsci/cloudbees-jenkins-advisor-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/advisor/casc/configuration-as-code.yaml
cloudbees-label-throttling-plugin	3.8	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-label-throttling-plugin/labelLimits.yaml
cloudbees-monitoring	2.9	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-monitoring-plugin/configuration-as-code.yml
cloudbees-nodes-plus	1.20	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-nodes-plus-plugin/configuration-as-code.yml
cloudbees-plugin-usage	2.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-plugin-usage-plugin/configuration-as-code.yml
cloudbees-request-filter	1.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-request-filter-plugin/configuration-as-code.yml
cloudbees-ssh-slaves	2.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-ssh-slaves-plugin/configuration-as-code.yml
config-file-provider	3.4	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/config-file-provider
credentials	2.2.0	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/credentials
deployer-framework	1.3	https://github.com/jenkinsci/deployer-framework-plugin/blob/bff9ac3e2e566e435eb56bcf3b57fbf08130a173/src/test/resources/com/cloudbees/plugins/deployer/casc/view-configuration.yml
docker-commons	1.17	https://github.com/jenkinsci/docker-commons-plugin/blob/3186bed061262e8a40cde9038ac3f6661339ea6f/src/test/resources/org/jenkinsci/plugins/docker/commons/casc_symbols.yaml
docker-workflow	1.23	https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/demos/docker-workflow/README.md
dockerhub-notification	2.5.0	https://github.com/jenkinsci/dockerhub-notification-plugin/blob/b635fd1979c47a8c8cc17a1635921dcc56ad9fca/src/test/resources/jcasc_symbols.yaml
electricflow	1.1.14	https://github.com/jenkinsci/electricflow-plugin/blob/master/src/test/resources/casc/configuration-as-code.yml
git	3.10.1	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/git
github-branch-source	2.5.8	https://github.com/jenkinsci/github-branch-source-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/github_branch_source/configuration-as-code.yaml
git-validated-merge	3.27	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/git-validated-merge-plugin/configuration-as-code.yml
github	1.29.5	https://github.com/jenkinsci/github-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/github/config/configuration-as-code.yml
google-compute-engine	4.3.0	https://github.com/jenkinsci/google-compute-engine-plugin/blob/develop/src/test/resources/com/google/jenkins/plugins/computeengine/configuration-as-code.yml
google-oauth	1.0.2	https://github.com/jenkinsci/google-oauth-plugin/tree/develop/src/test/resources/com/google/jenkins/plugins/credentials/oauth
gradle	1.30	https://github.com/jenkinsci/gradle-plugin/blob/master/src/test/resources/hudson/plugins/gradle/ConfigurationAsCodeTest/configuration-as-code.yml
jdk-tool	1.4	https://github.com/jenkinsci/jdk-tool-plugin/blob/9b72725d718a91bf1a57445652263f52e59bb984/src/test/resources/hudson/tools/casc.yaml
jira	3.0.12	https://github.com/jenkinsci/jira-plugin/blob/master/src/test/resources/hudson/plugins/jira/single-site.yml and https://github.com/jenkinsci/jira-plugin/blob/master/src/test/resources/hudson/plugins/jira/multiple-sites.yml
kube-agent-management	1.1.32	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/kube-agent-management-plugin/configuration-as-code.yml
kubernetes	1.25.3	https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/test/resources/org/csanchez/jenkins/plugins/kubernetes/casc
kubernetes-credentials	0.7.0	https://github.com/jenkinsci/kubernetes-credentials-plugin/blob/be230e03b7d10f2a6925b64b5fe5acf4069d6593/src/test/resources/org/jenkinsci/plugins/kubernetes/credentials/configuration-as-code.yaml
ldap	1.16	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/ldap
mailer	1.25	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/mailer
master-provisioning-kubernetes	2.5.1	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloud-platform-master-provisioning-plugin/configuration-as-code.yml
matrix-auth	2.4	https://github.com/jenkinsci/matrix-auth-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/matrixauth/integrations/casc/configuration-as-code.yml
maven	3.7	https://github.com/jenkinsci/maven-plugin/blob/master/src/test/resources/hudson/maven/maven-entries.yml
mercurial	2.4	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/mercurial
metrics	4.0.2.4	https://github.com/jenkinsci/metrics-plugin/blob/master/src/test/resources/jenkins/metrics/configuration-as-code.yaml
msbuild	1.29	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/msbuild
mstestrunner	1.3.0	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/mstestrunner
nodejs	1.3.6	https://github.com/jenkinsci/nodejs-plugin/blob/2f2bb53821e36c36d4348e66bac5ff61474c76da/src/test/resources/jenkins/plugins/nodejs/configuration-as-code.yaml
notification-api	1.2	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/notification-api-plugin/configuration-as-code.yml
pam-auth	1.6	https://github.com/jenkinsci/pam-auth-plugin/blob/master/src/test/resources/config.yaml
plain-credentials	1.5	https://github.com/jenkinsci/plain-credentials-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/plaincredentials/ConfigurationAsCode.yaml
saml	1.1.3	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/saml
script-security	1.64	https://github.com/jenkinsci/script-security-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/scriptsecurity/scripts/smoke_test.yaml
secure-requester-whitelist	1.4	https://github.com/jenkinsci/secure-requester-whitelist-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/secure_requester_whitelist/CasCTest.yml
skip-plugin	4.6	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/skip-plugin/skipGroupsFolder.yaml
ssh-credentials	1.17	https://github.com/jenkinsci/ssh-credentials-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/sshcredentials/jcasc/configuration-as-code.yaml
ssh-slaves	1.30.0	https://github.com/jenkinsci/ssh-slaves-plugin/blob/master/src/test/resources/hudson/plugins/sshslaves/SSHCasCConfig.yml
support-core	2.68	https://github.com/jenkinsci/support-core-plugin/blob/31ffccfe8004ac9f52d8cac813eba94d46e1bf61/src/test/resources/com/cloudbees/jenkins/support/configuration-as-code.yaml
trigger-restrictions	1.3	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/trigger-restrictions-plugin/labelLimits.yaml
timestamper	1.11.4	https://github.com/jenkinsci/timestamper-plugin/tree/5a129da1acf510c32582d7f4bfa4fb4fc4471b0e/src/test/resources/hudson/plugins/timestamper

Supported JDK versions

CloudBees CI on modern cloud platforms controllers run in a set of Docker containers that come pre-configured with OpenJDK 8. CloudBees does not support the modification of these containers.

If you build your own container images for agents, CloudBees recommends using only JDKs or JREs provided by either Oracle or OpenJDK for only the following versions:

Oracle JRE / JDK 8 - 64 bits
OpenJDK JDK / JRE 8 - 64 bits

If your agents are not running a recommended JDK version, CloudBees Support may ask you to move to one before diagnosing your problem. If you are running an outdated version of a recommended JDK, CloudBees Support may ask you to move to a more recent version since the more recent version may benefit from bug fixes and performance improvements. CloudBees recommends that you keep your JDK version up-to-date in any container images that you build yourself.

How CloudBees CI is affected by the end of public updates for Oracle Java 8

Oracle Java 8 reaches the end of public updates in December 2020. Java 11 is the next Java LTS. Therefore, CloudBees is actively working to modify CloudBees CI to run on Java 11.

Some of the CloudBees public activities surrounding Java 11 support can be viewed at the Jenkins Platform Special Interest Group.

Until CloudBees CI supports Java 11, CloudBees recommends using either:

An actively supported version of OpenJDK 8, such as those maintained by:
- (RHEL and CentOS) Red Hat (end-of-life (EOL) in 2020 or 2023)
- (Ubuntu and Debian) Canonical (EOL in 2021 with Ubuntu Xenial)

Alternately, you may purchase extended support from Oracle for the Oracle 1.8 JVM (EOL in December 2020).