The most simple deployment of PKE is a single-node installation without cloud integrations. This is useful for short-lived or development clusters.

Requirements 🔗︎

PKE is currently available for CentOS 7.x, RHEL 7.x, and Ubuntu 18.04 LTS. Your machine should have at least 2 CPU cores.

Installation 🔗︎

  1. Download and run the installer as root:

    curl -L -v https://banzaicloud.com/downloads/pke/latest -o /usr/local/bin/pke && chmod +x /usr/local/bin/pke
export PATH=$PATH:/usr/local/bin/

pke install single

  2. Set up the context for kubectl (run as your preferred user):

    mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

You can use kubectl from now on. Test it by executing kubectl get nodes.

Using the cluster remotely 🔗︎

You can find a Kubeconfig at /etc/kubernetes/admin.conf. It can be used from remote machines as well, but you may have to replace the auto-detected IP address in the URL under the clusters[0].cluster.server field.

Further reading 🔗︎

You can use the self-hosted or the free online version of Banzai Cloud Pipeline to deploy a cluster on AWS or Azure. You can check our specific PKE manual deployment guides for Vagrant, AWS, Azure, or VMware.