Install Kubernetes#

ClusterWareAI ™ administrators who want to use Kubernetes can either choose to install Kubernetes manually following directions from the distributor or use scripts provided by the clusterware-kubeadm package to install Kubernetes. The ClusterWareAI software bundles an upstream version of Kubernetes primarily maintained by Google. The Harvester and RKE2 distributions of Kubernetes are also tested and supported. If you want to use a different Kubernetes distribution, contact Penguin Computing.

The ClusterWareAI-provided scripts are based on the kubeadm tool and inherit both the benefits and limitations of that tool.

ClusterWareAI nodes and non-ClusterWareAI systems can be joined into the same Kubernetes cluster when the servers are on the same network.

Install the clusterware-kubeadm package:
- To use clusterware-kubeadm scripts on ClusterWareAI nodes, install the clusterware-kubeadm package on a server that a ClusterWareAI admin can use to access those nodes from cw-nodectl. Use the following command to install:
```
sudo dnf --enablerepo=cw* --enablerepo=scyld* install clusterware-kubeadm clusterware-tools
```
- To use clusterware-kubeadm scripts on non-ClusterWareAI servers, install the clusterware-kubeadm package on all of those servers. The scripts are run from each of those servers locally. Use the following command to install:
```
sudo dnf --enablerepo=cw* --enablerepo=scyld* install clusterware-kubeadm
```
Install your preferred distribution of Kubernetes.
- To install a pre-packaged upstream version of Kubernetes primarily maintained by Google, use the cw-kube tool to install the Kubernetes cluster as a ClusterWareAI administrator or root (for non-ClusterWareAI servers). The default Kubernetes version is hardcoded in /opt/scyld/clusterware-kubeadm/files/core/etc/yum.repos.d/kubernetes.repo.default and has been tested. If you want to install another version, append a specific version (major.minor.patch) argument to cw-kube. For example:
```
cw-kube --version 1.31.1
```
- To install a different Kubernetes distribution, such as Harvester or RKE2, use the instructions provided by your Kubernetes distribution.
Continue configuration based on your Kubernetes distribution.
- For mutable OS, such as the Kubernetes distribution packaged with the ClusterWareAI software, follow the steps in Configure Kubernetes with the Node Package on Operating System to set up the Kubernetes control plane and worker nodes with the ClusterWareAI software.
- For immutable OS, such as Harvester, follow the steps in Configure Kubernetes with the ClusterWareAI Container Registry to connect the pre-installed ClusterWareAI container registry to your Kubernetes cluster.