CloudBees Jenkins Enterprise provides a number of enterprise-grade features and
capabilities which help organizations scale continuous integration and delivery
(CI/CD). This "Getting Started" section assumes that: CloudBees Jenkins Enterprise is up and running
within the organization, the Administrator(s) have a functional
CloudBees Jenkins Enterprise project configured, and have downloaded/installed the
When new teams join an organization, or existing teams start a new project, CloudBees Jenkins Enterprise makes it easy to provision a fully managed and access controlled Jenkins master per team. In CloudBees Jenkins Enterprise, a Jenkins master is referred to as a Managed Master.
Administrators can provision Managed Masters, or they can allow team leads to provision their own Managed Masters "on-demand." The only limitation to the number of masters a CloudBees Jenkins Enterprise environment can handle is based on how much capacity the Administrator has added to the cluster.
By adding capacity, administrators can support more Managed Masters, Jenkins agents, or improve cluster performance and resiliency.
CloudBees Jenkins Enterprise allows administrators to standardize their organization’s Jenkins masters using Docker. Standardizing masters with containers makes it easy to ensure compliance with the organization’s security, audibility, and high availability requirements.
Out of the box, CloudBees Jenkins Enterprise includes some pre-made Docker master images that administrators can leverage to provision Managed Masters for their teams.
The full list of images can be found in the CloudBees Jenkins Enterprise global configuration under Manage Jenkins ⇒ Configure System. Navigate to the Mesos Master Provisioning section, and click on Show docker images… to review the available master images. The first entry in this list will be used as the default when creating a new master.
Whether an administrator wants to pre-provision masters, or a project lead wants to provision masters on-demand, the process for provisioning Managed Masters resembles the process for creating a new job in Jenkins.
After logging into CloudBees Jenkins Enterprise, navigate to the Operations Center dashboard, click the New Item option in the left-hand menu, and provide the following information:
Item name: the name of the new master to be provisioned for a team
Select Managed Master.
After clicking OK, CloudBees Jenkins Enterprise will present the Managed Master’s configuration page, where administrators can further customize the provisioned master’s settings.
Hardware settings: number of CPUs and amount of memory to allocate for the Managed Master
Docker image: custom containerized master image, instead of the image specified by the administrator in the Global System Configuration
After finalizing any configuration changes, click "Save" to provision the master.
Managed Masters are most efficiently monitored and modified through the Operations Center dashboard. Communication between Operations Center and Managed Masters is established automatically.
To view the newly provisioned master, click Back to Dashboard to return to the Operations Center dashboard. While provisioning, the Operations Center dashboard will display the new master as a pending state - indicated by thunder cloud health icons until the Managed Master ready. When ready, the weather icon will change into a cloud icon to indicate the master is ready to use.
To start a Managed Master, use Operations Center to browse to that master on the network and select Start from the sidebar. If the selected master is already running, then the Operations Center sidebar displays a Stop option.
Once the master is provisioned, administrators should configure security and access controls for the master.
CloudBees Jenkins Enterprise administrators may need to connect existing Jenkins masters to the CloudBees Jenkins Enterprise environment. While CloudBees Jenkins Enterprise supports this concept, called "Client Masters", the Client Masters lack some key benefits compared to Managed Masters, such as high availability.
Occasionally administrators will need to connect teams' existing masters to a CloudBees Jenkins Enterprise cluster, such as in the case of a team requiring a non-Linux operating system for their Jenkins master. Such existing masters cannot be fully managed by CloudBees Jenkins Enterprise and lack key benefits of Managed Masters like high availability. Whenever possible, administrators should encourage teams to instead upgrade to a Managed Master that is fully-managed by CloudBees Jenkins Enterprise.
Manually connected "Client Masters" can use the shared agents hosted in the cluster, offloading the burden of agent management from teams, and will still report their health to cluster administrators.
For more details on adding a "Client Master", refer to the "CD as a Service" section of this guide.
In order to provide teams with faster build times and minimize the times builds spending waiting for resources, administrators can add capacity to their cluster by configuring more workers for their cluster.
For more details on adding workers, refer to the "Operating" section of this guide.
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 CodeShip, CloudBees Jenkins Enterprise, CloudBees Jenkins Platform, CloudBees Jenkins Operations Center and DEV@cloud are trademarks of CloudBees, Inc.
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.