/hypershift-toolkit

Repository for work on hyperscale OpenShift deployment toolkit. Toolkit to run OpenShift control planes on a centralized management cluster.

Primary LanguageGoApache License 2.0Apache-2.0

Hypershift Toolkit

Overview

The hypershift toolkit is a set of tools and files that enables running OpenShift 4.x in a hyperscale manner with many control planes hosted on a central management cluster.

Getting Started

Installing on AWS

  • Install an Openshift 4.x cluster on AWS using the traditional installer
  • Run make hypershift-aws on this repository
  • Setup your KUBECONFIG to point to the admin kubeconfig of your current AWS cluster (ie. export KUBECONFIG=${INSTALL_DIR}/auth/kubeconfig)
  • Run ./bin/hypershift-aws install NAME to install a new Hypershift cluster on your existing AWS cluster. The NAME parameter will be used to create a namespace on your existing cluster and place all control plane components in it. Infrastructure will be created on AWS to support your new cluster instance, including:
    • Network Load Balancers for API, Router, VPN
    • DNS entries for API, Router, VPN
    • Worker machine instances for your new cluster

Uninstalling on AWS

  • Setup your KUBECONFIG to point to the management cluster
  • Run ./bin/hypershift-aws uninstall NAME where NAME is the name you gave your cluster when installing.