Guest clustering for OpenShift.
-
Admin access to an OpenShift cluster (version 4.7).
-
The OpenShift
oc
CLI tool. -
The
hypershift
CLI tool:$ make hypershift
Install HyperShift into the management cluster:
$ bin/hypershift install
Remove HyperShift from the management cluster:
$ bin/hypershift install --render | oc delete -f -
Prerequisites:
- A valid pull secret file for image pulls.
- An SSH public key file for guest node access.
- An aws credentials file.
Install the example cluster:
$ bin/hypershift create cluster \
--pull-secret /my/pull-secret \
--aws-creds /my/aws-credentials \
--ssh-key /my/ssh-public-key
When the cluster is available, get the guest kubeconfig using:
$ oc get secret --namespace example example-kubeconfig --template={{.data.value}} | base64 -D
To create additional node pools, create a resource like:
apiVersion: hypershift.openshift.io/v1alpha1
kind: NodePool
metadata:
namespace: clusters
name: example-extended
spec:
clusterName: example
autoScaling:
max: 0
min: 0
nodeCount: 1
platform:
aws:
instanceType: m5.large
And delete the cluster using:
$ oc delete --namespace clusters