Pivotal Container Service (PKS) enables operators to provision, operate, and manage enterprise-grade Kubernetes clusters on Pivotal Cloud Foundry (PCF).


PKS uses the On-Demand Broker to deploy Cloud Foundry Container Runtime, a BOSH release that offers a uniform way to instantiate, deploy, and manage highly available Kubernetes clusters on a cloud platform using BOSH.

After operators install the PKS tile on the Ops Manager Installation Dashboard, developers can provision Kubernetes clusters using the PKS Command Line Interface (PKS CLI), and run container-based workloads on the clusters with the Kubernetes CLI, kubectl.

PKS is available as part of Pivotal Cloud Foundry or as a stand-alone product.


PKS has the following features:

  • Kubernetes Compatibility: Constant compatibility with current stable release of Kubernetes

  • Production-ready: Highly available from applications to infrastructure, with no single points of failure

  • BOSH advantages: Built-in health checks, scaling, auto-healing and rolling upgrades

  • Fully automated operations: Fully automated deploy, scale, patch, and upgrade experience

  • Multi-cloud: Consistent operational experience across multiple clouds

  • GCP APIs access: The Google Cloud Platform (GCP) Service Broker gives applications access to the Google Cloud APIs, and Google Container Engine (GKE) consistency enables the transfer of workloads from or to GCP

PKS Components

The PKS control plane contains the following components:

For more information about the PKS control plane, see PKS Cluster Management.

NSX-T and Harbor are optional integrations for vSphere.

The GCP Service Broker is under development.

For a detailed list of components and supported versions by a particular PKS release, see the PKS Release Notes.

PKS Prerequisites

For information about the requirements for installing PKS, see PKS Prerequisites.

Preparing to Install PKS

To install PKS, you must deploy Ops Manager v2.0 or v2.1. You use Ops Manager to install and configure PKS.

If you are installing PKS to vSphere, you can also configure integration with NSX-T and Harbor.

Consult the following table for compatibility information:

IaaS Ops Manager v2.0 NSX-T Harbor
vSphere Required Available Available
GCP Required Not Available Not Available

For information about preparing your environment before installing PKS, see the topic that corresponds to your cloud provider:

Installing PKS

For information about installing PKS, see Installing and Configuring PKS.

Upgrading PKS

For information about upgrading the PKS tile and PKS-deployed Kubernetes clusters, see Upgrading PKS.

Managing PKS

For information about configuring authentication, creating users, and managing your PKS deployment, see Managing PKS.

Using PKS

For information about using the PKS CLI to create and manage Kubernetes clusters, see Using PKS.

Diagnostics and Troubleshooting PKS

For information about diagnosing and troubleshooting issues installing or using PKS, see Diagnosing and Troubleshooting PKS.