In today's world, we have several public cloud technologies that will ultimately help us with spinning up these infrastructures. This however comes with a price. Because a public cloud provider (like AWS or Azure) handles the API/master server and networking, you'll get something up quick, but miss some key lessons of spinning up a Kubernetes cluster. Today, I'll help you with that.
There are some pre-reqs for this blog:
1. At least 3 VM's. In my case, I'm using my ESXi 6.7 server at home.
2. Basic knowledge/understanding of what Kubernetes is utilized for.
3. Windows, Mac, or Linux desktop. For this blog, I am using Windows 10.
The first thing you want to do is spin up three virtual machines running Ubuntu18.04. You can use a RHEL based system, but the commands I show and run (including the repos I'm using) will be different.
I have already set up my 3 virtual machines. I gave them static IP addresses as I have found API/configuration issues if the VM shuts down or gets assigned a new IP address via DHCP.
Now, we want to log into the Kubernetes Master Node. The Master Node is what we use to host our API. The two additional VM's we have are the worker nodes. The Worker Nodes are what hold configurations and data (pods, deployments, etcd, etc.).
I called my three VM's kube-01, kube-02, and kube-03. kube01 is what I will be using for my Master.
The first thing we want to do is run
sudo apt update -y to ensure our Linux boxes have all updates (please run this on all 3 VM's).
The first thing we're going to install is apt-transport-https. This is for any package managers using libapt-pkg to access metadata and packages available in sources accessible over https. Please do this on all 3 VMs
apt-get install -y apt-transport-https curl
Next lets curl packages from Google needed for the Kubernetes repo.
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - cat </etc/apt/sources.list.d/kubernetes.list deb https://apt.kubernetes.io/ kubernetes-xenial main EOF
Next we'll do an
apt update -y to bring down updates from the Kubernetes repo we just added.
At this point, we are now ready to install kubelet, kubeadm, and kubectl. Please run the following:
apt-get install -y kubelet kubeadm kubectl
apt-mark hold kubelet kubeadm kubectl
We are setting the packages on hold so they are set off once we initialize our cluster.
Next, lets install Docker. After that we'll start the services.
apt install docker -y
systemctl enable docker
systemctl start docker
systemctl status docker
swapoff -a as Kubernetes is not compatible with it being on. Swap is memory stored in HD. Similar to a pagefile in Windows.
Next, lets go ahead and reload our daemon and restart kubelet as we added new configurations:
systemctl restart kubelet
Now let's go ahead and start our API server! We will need to initialize the cluster. Depending on your subnet, your api server address and pod network may be different than mine.
kubeadm init --apiserver-advertise-address 192.168.1.8 --pod-network-cidr=192.168.0.0/16
If all was completed successfully, you will see something similar to the screenshot below.
Copy all of that output, including the auth token and kubeadm join line. Store it someplace safe because we will need that for our worker nodes.
Next, you should see the commands that need to be run in your output for "To start using your cluster, you need to run the following as a regular user:"
Now let's get our networking set up. We're going to use Weave CNI. Weave CNI is a pretty solid standard, works "out of the box", and doesn't require additional configuration. Please run the following on your API/Master Node.
export kubever=$(kubectl version | base64 | tr -d '\n') kubectl apply -f "https://cloud.weave.works/k8s/net?k8s-version=$kubever"
Go ahead and run
kubectl get svc and
kubectl get cs. You should see a similar output to the below screenshot:
Now that our API server is up, lets head over to the worker nodes. On each worker node, you will need to run the following lines:
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add -
cat <<EOF >/etc/apt/sources.list.d/kubernetes.list deb https://apt.kubernetes.io/ kubernetes-xenial main EOF
apt install -y kubeadm kubelet kubectl
apt install docker.io -y
systemctl enable docker
At this point, you are ready to run your
kubeadm join line that was provided to you by your API.
After that, run
kubectl get nodes you'll see something like the below screenshot.
Now all of our nodes up and, statuses are ready, and we're all set!