Configuring Air Gap Kubernetes Host Settings

Download image and RPM files and configure settings for Kubernetes hosts in an air-gapped environment.


If you will be using an air-gap configuration for Kubernetes objects, then you must configure air-gap settings before adding any Kubernetes hosts.

Apply all air-gap settings with care. These settings do not propagate if updated after Kubernetes hosts have been installed unless one of the following occurs:

  • The Kubernetes host is rebooted.
  • The version of Kubernetes running on a host is upgraded.

Any Kubernetes hosts in a ready state that are not part of a Kubernetes cluster must be restarted for the changes to be applied.

Changing an existing HPE Ezmeral Runtime Enterprise configuration from a non-airgapped environment to an air-gapped environment forces a reinstall of Kubernetes clusters.

If you are changing an existing HPE Ezmeral Runtime Enterprise configuration from a non-airgapped environment to an air-gapped environment, contact Hewlett Packard Enterprise support for assistance before you begin the transition. Several manual steps must be performed to transition to an air-gapped environment.

For information about the requirements for air-gapped installation, see Kubernetes Air-Gap Requirements.

Air Gap File Download Locations

You can download files for air-gapped installation from the following locations:

Kubernetes container images (HPE Ezmeral Runtime Enterprise 5.4.0 and above)

For HPE Ezmeral Runtime Enterprise 5.4.0 and above, the complete set of air gap container image files can be downloaded with the air gap utility script. See Using the Air Gap Utility.

Installing Air-Gapped Kubernetes Hosts

To install Kubernetes hosts without internet access (air gap environment) do the following:

  1. Use the air gap utility script (Using the Air Gap Utility) to download container images and import them to a local filesystem or remote container registry.

    For information on using container registries, see either Existing Container Registry or New Container Registry, as appropriate.

  2. Configure the air-gap parameters. See Air Gap Tab.
  3. Proceed with adding the Kubernetes hosts.

New Container Registry

To use a new container registry:

  1. Create an open-source Docker registry. Refer to these instructions (link opens an external website in a new browser tab or window).

    You are not required to set up a Docker Trusted Registry.

  2. After the registry is deployed, follow the Existing Container Registry instructions to import the images into the registry.

Existing Container Registry

To use an existing container registry:
  1. Obtain the URL and credentials for your container registry.
  2. Proceed with Using the Air Gap Utility.