Install Kubernetes#

ICE ClusterWare ™ 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 ClusterWare 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 ClusterWare-provided scripts are based on the kubeadm tool and inherit both the benefits and limitations of that tool.

ClusterWare nodes and non-ClusterWare 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 ClusterWare nodes, install the clusterware-kubeadm package on a server that a ClusterWare admin can use to access those nodes from cw-nodectl. Use the following command to install:
```
sudo yum --enablerepo=cw* --enablerepo=scyld* install clusterware-kubeadm clusterware-tools
```
- To use clusterware-kubeadm scripts on non-ClusterWare 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 yum --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 ClusterWare administrator or root (for non-ClusterWare 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 ClusterWare 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 ClusterWare software.
- For immutable OS, such as Harvester, follow the steps in Configure Kubernetes with the ICE ClusterWare Container Registry to connect the pre-installed ClusterWare container registry to your Kubernetes cluster.