Supported platforms for CloudBees CI on modern cloud platforms

On this page

Supported Kubernetes
Supported Helm
Microsoft Windows container support
Supported NFS versions
Amazon Elastic File System (Amazon EFS) support
High Availability plugin support
Configuration as Code (CasC) for Masters support
Tier 1 and Tier 2 plugins support for Configuration as Code

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)
- Pivotal Container Service (PKS)
- 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.5, starting with CloudBees CI on modern cloud platforms version 2.204.3.4
Any 1.x version of a CNCF-certified Kubernetes, starting with 1.14

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.

Helm V3 (recommended)

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

Helm V2

Helm client, production release version 2.x, starting with version 2.12, installed locally.
If you are using Helm to manage your application deployment: Tiller server production release version 2.x, starting with version 2.12, installed on your Kubernetes cluster.

We recommend that you migrate to Helm V3 as soon as possible. Support of Helm V2 will be 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. Each cloud provider has various levels of support for Kubernetes features, including Windows containers, so confirm the status with your cloud platform provider.

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 does not recommend running CloudBees CI on Amazon EFS. CloudBees customers have observed multiple severe performance issues that have been confirmed by Amazon Support as expected behavior on EFS.

CloudBees recommends using Amazon Elastic Block Store (Amazon EBS) as an alternative. The EBS StorageClass handles the failover of a single machine, if enough spare capacity is available in the cluster, or auto-scaling is enabled and allowed for scale-up.

High Availability plugin support

High Availability (HA) on a Windows environment is not supported.

Configuration as Code (CasC) for Masters support

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

Specific issues with the Configuration as Code (CasC) for Masters within CloudBees CI on modern cloud platforms include:

Operations Center cannot be configured as code
Role-based access control is not supported

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.

These plugins are not supported on 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-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