CloudBees Jenkins Distribution installation guide
CloudBees Jenkins Distribution provides development teams with a highly dependable, secure Jenkins environment curated from the most recent supported Jenkins release. The distribution comes with a recommended catalog of tested plugins available through the CloudBees Assurance Program.
Upgrades are now a smooth, seamless experience with the Beekeeper Upgrade Assistant. The Beekeeper Upgrade Assistant works in parallel with the CloudBees Assurance Program to provide a centralized view of the monitored Jenkins plugins, as well as recommended actions and configuration options. The free CloudBees Jenkins Advisor plugin keeps an eye out for potential issues and recommendations and sends you email notifications with suggestions tailored to your installation.
CloudBees Jenkins Distribution considerably simplifies the installation and configuration process, and Configuration as Code makes the configuration of CloudBees Jenkins Distribution even easier. With Configuration as Code, you can turn complex configurations into easily-replicated, human-readable code files, and you can manage those configuration files with source control tools like GitHub.
The CloudBees Jenkins Distribution License Report lists the included plugins.
|If you are already using Jenkins LTS, refer to Migrating from Jenkins LTS to CloudBees Jenkins Distribution if you are interesting in using CloudBees Jenkins Distribution.|
CloudBees Jenkins Distribution is available as a standalone WAR file, which can run in practically any Java runtime environment. CloudBees provides installation packages for the following platforms:
Debian or Ubuntu
Red Hat Enterprise Linux, CentOS, Fedora
openSUSE or SUSE Linux
CloudBees Jenkins Distribution can be installed on Kubernetes clusters as well.
|Visit Supported platforms for CloudBees Jenkins Distribution for details.|
Installing CloudBees Jenkins Distribution involves the following steps:
Downloading and installing the CloudBees Jenkins Distribution package, Docker image, or WAR file
Using the Getting Started wizard to set up the plugins and first admin account.
Distribution packages are available at the CloudBees Jenkins Distribution download site.
CloudBees Jenkins Distribution requires at least 512 MB of RAM and 2 GB of disk space. The recommend system requirements, at least 4 GB of RAM and 50 GB+ of free disk space, provide room to grow with workloads.
There are no universally applicable operating system-level requirements, but depending on the workload placed on the instance, your instance may require changes to certain tunables such as heap size or open file descriptor limits.
You must have an installed and configured Docker environment to use the Docker image.
The native packages and Docker containers for CloudBees Jenkins Distribution include a Java runtime environment. Administrators wishing to run the WAR file on its own, or deploy CloudBees Jenkins Distribution in a Java Servlet Container should bear in mind that CloudBees supports:
Oracle JRE 8
Oracle JDK 11 (CloudBees Jenkins Distribution versions 2.164 and later only)
OpenJDK JRE 8
OpenJDK JDK 11 (CloudBees Jenkins Distribution versions 2.164 and later only)
CloudBees Jenkins Distribution may run on older, non-supported Java runtime environments. Administrators running older versions of Java should expect best effort support for any potential technical issues which may arise. Please refer to the Supported JDKs section for more detailed information.
Online version published by CloudBees, Inc. under the Creative Commons Attribution-ShareAlike 4.0 license.
CloudBees and CloudBees DevOptics are registered trademarks and CloudBees Core, CloudBees Flow, CloudBees Flow Deploy, CloudBees Flow DevOps Insight, CloudBees Flow DevOps Foresight, CloudBees Flow Release, CloudBees Accelerator, CloudBees Accelerator ElectricInsight, CloudBees Accelerator Electric Make, CloudBees CodeShip, CloudBees Jenkins Enterprise, CloudBees Jenkins Platform, CloudBees Jenkins Operations Center, and DEV@cloud are trademarks of CloudBees, Inc.
Most CloudBees products are commonly referred to by their short names—Accelerator, Automation Platform, Flow, Deploy, Foresight, Release, Insight, and eMake—throughout various types of CloudBees product-specific documentation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
The registered trademark Jenkins® is used pursuant to a sublicense from the Jenkins project and Software in the Public Interest, Inc. Read more at www.cloudbees.com/jenkins/about.
Apache, Apache Ant, Apache Maven, Ant and Maven are trademarks of The Apache Software Foundation. Used with permission. No endorsement by The Apache Software Foundation is implied by the use of these marks.
Other names may be trademarks of their respective owners. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this content, and CloudBees was aware of a trademark claim, the designations have been printed in caps or initial caps.
While every precaution has been taken in the preparation of this content, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.