- AWS
- Libvirt with KVM
- OpenStack (Experimental)
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 requires the terraform binary either alongside openshift-install or in $PATH
.
If you don't have terraform, run the following to create bin/terraform
:
hack/get-terraform.sh
The installer will show a series of prompts for user-specific information (e.g. admin password) and use reasonable defaults for everything else. In non-interactive contexts, prompts can be bypassed by providing appropriately-named environment variables. Refer to the user documentation for more information.
Shortly after the cluster
command completes, the OpenShift console will come up at https://${OPENSHIFT_INSTALL_CLUSTER_NAME}-api.${OPENSHIFT_INSTALL_BASE_DOMAIN}:6443/console/
.
You may need to ignore a certificate warning if you did not configure a certificate authority known to your browser.
Log in using the admin credentials you configured when creating the cluster.
You can also use the admin kubeconfig which openshift-install create cluster
placed under --dir
(which defaults to .
) in auth/kubeconfig
.
If you launched the cluster with openshift-install --dir "${DIR}" create cluster
, you can use:
export KUBECONFIG="${DIR}/auth/kubeconfig"
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.