Skip to content

Run Kubernetes

These pages are for operators who run a Kubernetes cluster on nodes whose image lists the Kubernetes layer. They build on Operate nodes: they assume a workstation with the secrets file, and nodes installed as Install a node describes. Plan the cluster before you install its nodes, because a few of its settings are fixed once it runs. The other pages follow in order: bootstrap the cluster, configure it, run its control plane on several nodes, serve its images from the control planes, announce its addresses over BGP, upgrade Kubernetes, rotate its CAs and keys, and find out why it misbehaves.

Set up

These pages take a cluster from its plan to a highly available control plane, which may serve the cluster's images and whose nodes may announce their addresses over BGP.

  • Plan a cluster


    Decide the control planes, the cluster endpoint, the address families and scheduling before installing a cluster.

    Read

  • Bootstrap and get a kubeconfig


    Start the cluster on its first control plane, watch the other nodes join and issue kubeconfigs for its Kubernetes API.

    Read

  • Configure Kubernetes


    Set the cluster's settings, each node's labels, taints and flags, the pod network and your own add-ons.

    Read

  • Run a highly available control plane


    Run three control planes behind a virtual IP, and add, replace or remove one.

    Read

  • Run an air-gapped cluster with the cluster registry


    Serve container images from the control planes to a cluster that cannot reach their registries, and push, check and delete them on every control plane.

    Read

  • Announce addresses with BGP


    Announce the nodes' addresses and the routed VIP to the fabric's routers, and take the default route they send.

    Read

Maintain

These pages keep a running cluster current and fix what goes wrong.

  • Upgrade Kubernetes


    Move to a new Kubernetes release, and keep etcd's quorum and the workloads within their PodDisruptionBudgets while nodes reboot.

    Read

  • Rotate the Kubernetes CAs and keys


    Replace the Kubernetes CAs, the service-account key and the encryption key, and revoke Kubernetes access.

    Read

  • Troubleshoot Kubernetes


    Find out why a node's Kubernetes does not start, join, serve logs or reach other nodes' pods.

    Read