8066014ea0
** While the regional support is valid, we will not be using this in openshift. Regional support requires that each api have its own endpoint. Only one api is associated with an endpoint, and managing this access will be difficult and unnessary at this time.
OpenShift Installer
Supported Platforms
- AWS (Official Docs)
- Azure (Official Docs)
- Bare Metal (Official Docs)
- GCP (Official Docs)
- IBM Cloud (Official Docs)
- Nutanix (Official Docs)
- OpenStack (Official Docs)
- Power (Official Docs)
- Power VS (Official Docs)
- vSphere (Official Docs)
- z/VM (Official Docs)
Quick Start
First, install all build dependencies.
Clone this repository. Then build the openshift-install binary with:
hack/build.sh
This will create bin/openshift-install. This binary can then be invoked to create an OpenShift cluster, like so:
bin/openshift-install create cluster
The installer will show a series of prompts for user-specific information and use reasonable defaults for everything else.
In non-interactive contexts, prompts can be bypassed by providing an install-config.yaml.
If you have trouble, refer to the troubleshooting guide.
Connect to the cluster
Details for connecting to your new cluster are printed by the openshift-install binary upon completion, and are also available in the .openshift_install.log file.
Example output:
INFO Waiting 10m0s for the openshift-console route to be created...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run
export KUBECONFIG=/path/to/installer/auth/kubeconfig
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.${CLUSTER_NAME}.${BASE_DOMAIN}:6443
INFO Login to the console with user: kubeadmin, password: 5char-5char-5char-5char
Cleanup
Destroy the cluster and release associated resources with:
openshift-install destroy cluster
Note that you almost certainly also want to clean up the installer state files too, including auth/, terraform.tfstate, etc.
The best thing to do is always pass the --dir argument to create and destroy.
And if you want to reinstall from scratch, rm -rf the asset directory beforehand.