CloudBees Core on Kubernetes installation guide

This document explains how to install on generic Kubernetes cluster running on your own infrastructure or AWS. If you are installing on Google Kubernetes Engine (GKE), then you should refer instead to the Installation Guide for GKE.

The Kubernetes cluster requirements must be satisfied before CloudBees Core can be installed.

Kubernetes Cluster Requirements

For details about supported platforms for CloudBees Core on modern cloud platforms, such as supported Kubernetes, Helm, and NFS versions, refer to Supported platforms for CloudBees Core on modern cloud platforms.

The CloudBees Core installer requires:

  • On your local computer or a bastion host:

    • Kubernetes client 1.x, starting with 1.10, installed and configured (kubectl)

  • A cluster running running Kubernetes 1.x, starting with 1.10, as long as it is actively supported by the Kubernetes distribution provider and generally available

    • Kubernetes cluster nodes in each availability zone

    • Must have network access to container images (public Docker Hub or a private Docker Registry)

  • The NGINX Ingress Controller installed in the cluster.

    • Load balancer configured and pointing to the NGINX Ingress Controller

    • A DNS record that points to the NGINX Ingress Controller Load balancer

    • TLS certificates (needed when you deploy CloudBees Core)

  • A namespace in the cluster (provided by your admin) with permissions to create Role and RoleBinding objects

  • Kubernetes cluster Default Storage Class defined and ready to use

    • Refer to the relevant Reference Architecture for AWS or On-premise - Storage Requirements section for more information.

Kubernetes beta releases are not supported. Use production releases.