Run OpenShift 4.0 locally

Note: Experimental for Mac and Linux

Virtualbox on macOS

Prerequisites

• Virtualbox (>= 5.2.x)
• oc 4.0.0

Steps

• set up environment:

$ export KUBECONFIG=/path/to/minishit_virtualbox_0.9.1/
$ chmod +x ./minishift_virtualbox.sh

• create and start cluster:

$ ./minishift_virtualbox.sh create
$ ./minishift_virtualbox.sh start

The script is using a sudo command you'll be prompted for your root password.

NOTE: the script run some verification that port 53 is not already in used, double check is the port is not in used with sudo lsof -i -n -P | grep TCP

NOTE: to verify coredns is running, look at log sudo cat /tmp/coredns.log

How to expose the webconsole

• You need to wait till the cluster is in healthy state, check if all pods are running:

$ oc get pods --all-namespaces

wait untill CrashLoopBackOff pods are up restarted.

hyperkit on macOS

Prerequisites

• hyperkit (brew install hyperkit)

$ sudo chown root:wheel $(brew --prefix)/opt/hyperkit/bin/hyperkit
$ sudo chmod u+s $(brew --prefix)/opt/hyperkit/bin/hyperkit

• oc 4.0.0

How to expose the webconsole

• Export the kubeconfig which is in the tarball export KUBECONFIG=<TARBALL_EXTRACT_PATH>/kubeconfig
• You need to wait till the cluster is in healthy state, check if all pods are running oc get pods --all-namespaces after exporting the kubeconfig file.
• openshift/installer#411 (comment)

Get the routes and add bind them to 127.0.0.1 in /etc/hosts:

$ oc get --all-namespaces routes
NAMESPACE           NAME      HOST/PORT                                         PATH      SERVICES   PORT      TERMINATION          WILDCARD
openshift-console   console   console-openshift-console.apps.test1.tt.testing             console    https     reencrypt/Redirect   None

Use console-openshift-console.apps.test1.tt.testing from the get routes above in the hosts file below.

$ echo "127.0.0.1 console-openshift-console.apps.test1.tt.testing" | sudo tee -a /etc/hosts

$ sudo oc --config kubeconfig -n openshift-ingress port-forward svc/router-internal-default 443

Leave this running in the terminal.

Running it

In the browser use https://console-openshift-console.apps.test1.tt.testing

To login use:

• admin: kubeadmin
• password: [look in kubeadmin-password]

Linux

Prerequisites

• Currently script prerequisite part only support RHEL/Fedora/CentOS.
• If you using a different distribution then you need to edit the script around how to install the libvirt packages and make the config changes.

Steps

Run these commands from the installed/extracted directory:

• export KUBECONFIG=[path-to-config]/kubeconfig
• ./crc_libvirt.sh create
• ./crc_libvirt.sh start

How to expose the webconsole

• You need to wait till the cluster is in healthy state, check if all pods are running oc get pods --all-namespaces after exporting the kubeconfig file.
• openshift/installer#411 (comment)

Get the routes and add bind them to 127.0.0.1 in /etc/hosts:

$ oc get --all-namespaces routes
NAMESPACE           NAME      HOST/PORT                                         PATH      SERVICES   PORT      TERMINATION          WILDCARD
openshift-console   console   console-openshift-console.apps.test1.tt.testing             console    https     reencrypt/Redirect   None

Use console-openshift-console.apps.test1.tt.testing from the get routes above in the hosts file below.

$ echo "127.0.0.1 console-openshift-console.apps.test1.tt.testing" | sudo tee -a /etc/hosts

Allow kubectl to bind to privileged ports:

$ sudo setcap CAP_NET_BIND_SERVICE=+eip /usr/bin/kubectl

Note: If you omit the above, you have to start kubectl using sudo. Next, port-forward the router-default service:

$ kubectl -n openshift-ingress port-forward svc/router-internal-default 443

Leave this running in the terminal.

Running it

In the browser use https://console-openshift-console.apps.test1.tt.testing

To login use:

• admin: kubeadmin
• password: [look in kubeadmin-password]

Community

Contributions, questions, and comments are all welcomed and encouraged!

• You can talk to the community at #codeready channel on Freenode IRC