The following section describes how to install Minishift and the required dependencies.
These are the basic steps for setting up Minishift on your personal system:
The setup procedure should be run as a regular user with permission to launch virtual machines. In the procedure, you will see how to assign that permission, along with ways to configure your hypervisor and command shell to start and effectively interact with Minishift.
Minishift can be installed on Windows, Linux and Mac but depending on your platform, you will need to configure a compatible hypervisor in order for the OpenShift cluster to be created within the virtualised environment. Verify that the hypervisor of your choice is installed and enabled on your system before you set up Minishift. Once the hypervisor is up and running, additional setup is required for Minishift to work with that hypervisor.
See the appropriate section for your hypervisor and operating system:
- For Linux, set up the KVM driver
- For macOS,
set up the xhyve driverorset up the hyperkit driver - For Windows, set up the Hyper-V driver
- For VirtualBox (all platforms), set up Minishift to use VirtualBox
NOTE: If you have installed docker-ce for Mac on your machine, the hyperkit driver is already installed
To download Minishift, you can either install from source or if on Mac, you can install using Homebrew.
Providing you have completed the previous steps successfully, you will now be ready to start the OpenShift server. To do so, you should be able to run:
$ minishift start --vm-driver <driver>
Make sure to replace <driver> with the driver that you have used e.g. 'hyperkit' or 'virtualbox'. Once successfully started, you should be given the credentials to login to the cluster and the UI address as shown below:
OpenShift server started.
The server is accessible via web console at:
https://192.168.64.11:8443/console
You are logged in as:
User: developer
Password: <any value>
To login as administrator:
oc login -u system:admin
-- Exporting of OpenShift images is occuring in background process with pid 5703.
NOTE: Both your console address and your pid will be different.
After setting up your cluster, you may have specific requirements that you want to enforce in your cluster. The minishift tool allows you to manage the lifecycle of the single-node OpenShift cluster as well as set environment variables, persistent storage and proxy options if your machine is behind a proxy. For more information on these configurations, see the following link.
Once you are all set up, you can move on to Lab 1