Here's a set of instructions for running the Red Hat CDK (local OpenShift instance) on Fedora, from someone who uses it almost every day.
The Red Hat Container Development Kit (based on Minishift) is compatible with several virtualization architectures. For Fedora, I use KVM.
Make sure virtualization is enabled
If the following command returns some matches, you should be good.
$ cat /proc/cpuinfo | egrep "vmx|svm"
If you see no output, you may need to enable virtualization in your BIOS (procedures vary depending on your machine).
Install virtualization packages
$ sudo dnf install libvirt qemu-kvm
Start and enable libvirtd
$ sudo systemctl start libvirtd
$ sudo systemctl enable libvirtd
Download the CDK
The file that you downloaded is the
minishift binary, not an installer. There's nothing to unpack or unarchive or anything like that. The goal is just to get it onto your path so you can issue
minishift ... commands. Here's what I do:
Make a directory wherever you like to install software. I like to put vendor software in
/opt so for me:
$ sudo mkdir /opt/cdk
Move the downloaded Minishift binary into that directory, for example:
$ sudo mv ~/Downloads/cdk-3.7.0-2-minishift-linux-amd64 /opt/cdk/
Make sure it's executable:
$ sudo chmod +x /opt/cdk/cdk-3.7.0-2-minishift-linux-amd64
Make a symlink called
minishift in the same directory and point to the CDK binary:
$ sudo ln -sfn /opt/cdk/cdk-3.7.0-2-minishift-linux-amd64 /opt/cdk/minishift
Make sure we're good so far:
$ /opt/cdk/minishift version minishift v1.27.0+cbc3048 CDK v3.7.0-2
Why symlink? I can manage multiple versions in
/opt/cdk and point to the one I want to use. If it feels over-the-top for you, no worries, just rename the Minishift binary to
Next, add the
/opt/cdk directory to your path (permanently):
echo 'export PATH=$PATH:/opt/cdk' >> ~/.bashrc
$ minishift version minishift v1.27.0+cbc3048 CDK v3.7.0-2
$ minishift setup-cdk
Start minishift with:
$ minishift start
I usually allocate resources with
$ minishift start --cpus 3 --memory 10
And I often need to specify an OpenShift version with the
$ minishift start --ocp-tag 3.11.82 --cpus 3 --memory 10G
--ocp-tag flag will become
--openshift-version in CDK v3.8.
Note: At the moment there is a bug preventing proper OpenShift tag validation. To skip the validation:
$ minishift config set skip-check-openshift-release true
When you start Minishift it will ask you for your Red Hat credentials to subscribe your cluster instance.
Point to the specific oc client version automatically downloaded by Minishift to your machine.
$ eval $(minishift oc-env)
Now you should be able to log in with full cluster privileges:
$ oc login -u system:admin