Kubernetes Worker Installation Overview

Describes how to add a host to HPE Ezmeral Runtime Enterprise as a Kubernetes worker for compute workloads.

Prerequisites

  • Hewlett Packard Enterprise recommends enabling platform High Availability before adding a large number of Kubernetes.

  • Ensure that hosts conform to the requirements described in Host Requirements and Kubernetes Host/Node Requirements.

    If the firewalld service is installed and enabled on the Controller, and the firewalld service is installed and enabled on all hosts before they are added to the deployment, the installer for HPE Ezmeral Runtime Enterprise automatically configures firewall rules to open the required ports listed in Port Requirements and Kubernetes Port Requirements.

    CAUTION

    Numerous configuration changes occur to the host during installation that are required in order for the platform to function. These changes are not completely reversible and may impact any other applications and processes that are currently running on the host. It is strongly recommended that you install HPE Ezmeral Runtime Enterprise on a host that is not being used for any other purpose in order to avoid possible disruptions to your business processes.

    Installing HPE Ezmeral Runtime Enterprise on any host that does not meet all applicable requirements may lead to unpredictable behavior and/or data loss.

  • For best results, it is recommended that all compute hosts in a cluster share the same configuration (CPU, RAM, storage, OS, etc.).

  • If this host has MIG-enabled GPUs that are supported by HPE Ezmeral Runtime Enterprise, install the NVIDIA driver on the host and configure MIG before adding the host to HPE Ezmeral Runtime Enterprise.

    See Deploying MIG Support.

  • If you want to install the Falco Kernel Module on the host as part of the Falco Container Runtime Security feature, install the module on the host after you install the host OS but before you add the host to HPE Ezmeral Runtime Enterprise.
  • See Falco Container Runtime Security.

About this task

This article describes adding Kubernetes hosts for compute workloads.

Procedure

  1. Prepare the hosts to be added as Kubernetes hosts.
  2. If you are adding hosts to expand a Kubernetes cluster that has not been migrated to the Hewlett Packard Enterprise distribution of Kubernetes, create the following touch file on each host: 
    touch /tmp/k8s_docker_override

    Creating the touch file specifies that the Docker container runtime is used instead of the containerd runtime.

  3. In the web interface, select the hosts to add as Kubernetes Workers.

    See Kubernetes Host: Select the Hosts.

  4. Add the Worker hosts.

    See Kubernetes Host: Add the Hosts.

  5. Select the hard drives on the Worker hosts.

    See Kubernetes Host: Select Hard Drives.

  6. Place HPE Ezmeral Runtime Enterprise into Lockdown mode.

    For more information, see Kubernetes Host: Enter Lockdown Mode.

  7. Install the hosts as Kubernetes Workers.

    See Kubernetes Host: Add the Hosts as Workers.

    HPE Ezmeral Runtime Enterprise verifies that the number of CPU cores in the hosts do not exceed the licensed maximum, and then proceeds with the installation. The UI displays a green Installing bar for each of the new hosts.

  8. Exit Lockdown mode.
  9. On each host, prevent the yum update command from updating the Kubernetes repo by setting enabled=0 in the following file: /etc/yum.repos.d/bd-kubernetes.repo
  10. Validate that the new Kubernetes Worker has been correctly added and is functioning properly.

    See Kubernetes Host: Validate the Worker Installation.