Getting started with CloudBees Core on modern cloud platforms

Welcome to the getting started guide! This guide will help you understand and install CloudBees Core on modern cloud platforms on Kubernetes platforms. This guide will go over the basic tasks to get CloudBees Core on modern cloud platforms up and running.

Planning for installation

Before jumping to the implementation, you should understand the infrastructure and skills needed to do an installation, as well as onboarding users and applications. You can take a look at this CloudBees Core on modern cloud platforms planning guide for some important topics to consider before installation, such as verifying you are using a supported Kubernetes version, that you can have access to a namespace in Kubernetes, and other items.

Kubernetes cluster prerequisites per cloud provider

Kubernetes and containerization knowledge prerequisites

CloudBees Core on modern cloud platforms is a stateful containerized application that is composed of multiple Kubernetes resources, such as Ingress, persistent volumes, and service accounts. Because of this, it is necessary to have a solid understanding of these resources.

CloudBees Core Managed Masters deploy container-based ephemeral agents on demand to complete jobs, which means a strong knowledge of containerization is vital in order to create, use and maintain such containers.

CloudBees recommends that your team becomes proficient with Kubernetes. The Cloud Native Computing Foundation (CNCF) offers training that can help you understand the architecture and concepts of Kubernetes.

Kubernetes in production

Running Kubernetes in production at a large scale goes beyond CloudBees Core and your team needs to account for considerations, such as cluster monitoring, governance, logging, security and resiliency. We recommend that you follow the recommendations of your Kubernetes provider. The following are articles about this topic from public cloud providers:

Physical architecture

In order to understand what you are going to be installing, go to the CloudBees Core reference architecture - Kubernetes, select your Kubernetes distribution and review the Kubernetes terminology and resources. The "CloudBees Core Kubernetes resources" section explain each of the Kubernetes resources that will be installed. You can also find important information about agent and master provisioning, ports needed and a visualization of the CloudBees Core architecture explained using Kubernetes resources.

Physical architecture
Figure 1. Physical architecture

Installation using Helm 3 and initial setup

This is a video series about how to install and begin the initial setup of CloudBees Core. The installation video shows you how to use the CloudBees Core Helm chart with HTTPS support and NGINX Ingress Controller, if you don’t have it already. Even though the video series focuses on GKE, it is a good resource for other cloud providers as it provides a set of tasks that are not specific to a certain Kubernetes provider.

Documentation overview: prerequisites and Helm introduction
Helm values, TLS secret creation, installation and Kubernetes resources overview
External IP, CloudBees license and key in Operations Center and first user creation
Provisioning a new Managed Master

Validation

Use the following tool to determine if your Kubernetes cluster meets the known requirements for CloudBees Core on modern cloud platforms:

The validation tool also extends Sonobuoy to run compliance tests for your Kubernetes cluster.

Maintenance

The following options are available to help you to maintain CloudBees Core on modern cloud platforms:

Security

Review the following security information: