Skip to content

Setting up ESS Pro Helm Chart in Air-gapped environments

Prerequisites

  • If you want to setup ESS Pro in a single node k3s cluster like suggested in the Setup Guide, you need to follow k3s Airgap instructions using the Private Registry Method.
  • If you have your own Kubernetes airgapped cluster, you need uploaded access to a private registry that can be used to host the ESS Pro images.
  • You need to install skopeo on the computer used to upload the images.
  • You need to login against the registry if it requires credentials: skopeo login <registry url> -u <username> -p <password>

Instructions

  • You need to reach your account manager to get access to the airgapped bundles built by Element.
  • The airgapped bundles are available on the Element On-Premise Downloads page
  • Download the bundle named ess-pro-airgapped-<version>.tar.gz, where <version> is the version of the ESS Pro matrix-stack chart you want to install.
  • Copy the bundle over to your airgapped network, with access to the private registry.
  • Extract the contents of the bundle to a directory on your airgapped network: tar -xvf ess-pro-airgapped-<version>.tar.gz
  • In the extracted directory, extract the archive of the chart tar -xvz airgapped/charts/matrix-stack/matrix-stack-<version>.tgz.
  • Call the upload script against the extract airgapped images: bash matrix-stack/scripts/import_airgapped_bundle_into_registry.sh ./--airgapped-bundle airgapped/ --registry <registry url>. If you registry does not support HTTPS, you need to use the --no-tls flag.
  • The script will upload the images missing from the private registry, and generate values files overriding the default ones in images_uploaded.values.yaml
  • Use the values file with your other ess config values when setting up the ESS Pro Helm chart