Installation & Setup
CLI tools
The following CLI tools are required for running the exercises in this tutorial. Please have them installed and configured before you get started with any of the tutorial chapters.
| Tool | macOS | Fedora | windows |
|---|---|---|---|
|
|||
|
|
||
|
|||
Minikube v1.29.0 |
|||
|
|||
|
|||
|
The following CLI tools are optional for running the exercises in this tutorial. Although they are used in the tutorial, you could use others without any problem.
| Tool | macOS | Fedora | windows |
|---|---|---|---|
|
|
||
watch |
|
|
|
kubectx and kubens |
|
||
|
Download Tutorial Sources
Before we start setting up the environment, let’s clone the tutorial sources and set the TUTORIAL_HOME environment variable to point to the root directory of the tutorial:
Before we start setting up the environment, let’s clone the tutorial sources and set the TUTORIAL_HOME environment variable to point to the root directory of the tutorial:
git clone https://github.com/redhat-scholars/kubernetes-tutorial kubernetes-tutorialexport TUTORIAL_HOME="$(pwd)/kubernetes-tutorial"cd $TUTORIAL_HOME|
This tutorial was developed and tested with:
|
Install Minikube
mkdir bin && cd binchmod +x minikubechmod +x kubectlcd ..mkdir bin && cd binchmod +x minikubechmod +x kubectlcd ..mkdir bin && cd bincd ..And then set environment variables:
export MINIKUBE_HOME=$TUTORIAL_HOME;
export PATH=$MINIKUBE_HOME/bin:$PATH
export KUBECONFIG=$MINIKUBE_HOME/.kube/config
export KUBE_EDITOR="code -w"set MINIKUBE_HOME=%TUTORIAL_HOME%
set PATH=%MINIKUBE_HOME%/bin:%PATH%
set KUBECONFIG=%MINIKUBE_HOME%/.kube/config
set KUBE_EDITOR="code -w"Start Kubernetes
There are a series of commands as steps that allow you to get started with minikube. The following section shows how to start minikube with minimal and required configurations:
The profile devnation is created to run the tutorial:
Having minikube installed and in your PATH, then run:
MacOS
minikube start --memory=8192 --cpus=3 --kubernetes-version=v1.26.1 --vm-driver=virtualbox -p devnationLinux
minikube start --memory=8192 --cpus=3 --kubernetes-version=v1.26.1 --vm-driver=kvm2 -p devnationWindows:
minikube start --memory=8192 --cpus=3 --kubernetes-version=v1.26.1 --vm-driver=hyperv -p devnationAnd the output must be something similar like:
😄 [devnation] minikube v1.20.0 on Darwin 11.3
✅ Created a new profile : devnation
✅ minikube profile was successfully set to devnation
😄 [default] minikube v1.29.0 on Darwin 11.3
✨ Selecting 'virtualbox' driver from user configuration (alternates: [hyperkit])
🔥 Creating virtualbox VM (CPUs=2, Memory=8192MB, Disk=50000MB) ...
🐳 Preparing Kubernetes v1.26.1 on Docker '20.10.6' ...
▪ apiserver.enable-admission-plugins=LimitRanger,NamespaceExists,NamespaceLifecycle,ResourceQuota,ServiceAccount,DefaultStorageClass,MutatingAdmissionWebhook
🚜 Pulling images ...
🚀 Launching Kubernetes ...
⌛ Waiting for cluster to come online ...
🏄 Done! kubectl is now configured to use "devnation"Finally configure to use minikube internal docker as docker host:
eval $(minikube docker-env -p devnation)To run OpenShift4, you need to have one provisioned using try.openshift.com or can use any existing OpenShift4 cluster. Once you have your cluster, you can download the latest OpenShift client(oc) from here and add to your path.
oc version
You can check the OpenShift version using:
oc versionThe output should show oc version >=4.7:
Client Version: 4.7.0-202102130115.p0-c66c03f
Kubernetes Version: v1.26.1Then login into the OpenShift cluster using oc login