0055065143
This adds experimental support for the baremetal IPI platform. Baremetal IPI is implemented via a libvirt bootstrap VM, and an Ironic instance that handles provisioning of baremetal nodes. This baremetal platform is still experimental and relies on the openshift-metal3/dev-scripts to perform a complete deployment. Co-authored-by: Antoni Segura Puimedon <antoni@redhat.com> Co-authored-by: Ben Nemec <bnemec@redhat.com> Co-authored-by: Derek Higgins <derekh@redhat.com> Co-authored-by: Eduardo Minguez Perez <e.minguez@gmail.com> Co-authored-by: Mark McLoughlin <markmc@redhat.com> Co-authored-by: Russell Bryant <rbryant@redhat.com> Co-authored-by: Sandhya Dasu <sdasu@redhat.com> Co-authored-by: Stephen Benjamin <stephen@redhat.com> Co-authored-by: Steven Hardy <shardy@redhat.com> Co-authored-by: Yolanda Robla <yroblamo@redhat.com>
OpenShift Installer
Supported Platforms
- AWS
- Bare Metal (UPI)
- Bare Metal (IPI) (Experimental)
- Libvirt with KVM (development only)
- OpenStack (experimental)
- vSphere
Quick Start
First, install all build dependencies.
Clone this repository to src/github.com/openshift/installer in your GOPATH. 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 install and destroy.
And if you want to reinstall from scratch, rm -rf the asset directory beforehand.