Deploying An Asp.Net WebApi and MySql DataBase Container to Kubernetes (Part-1)-SetUp

This article is a follow-up to my previous article on containerizing an Aspnet.core API and MySQL database with docker-compose. In this article, we are going to be going one step further by deploying the Web API to Kubernetes.

I have split this process into two parts for brevity.

Part 1. Setting up Kubernetes and Kubernetes Dashboard using Docker Desktop.
Part 2. Deploying the.NetCore Web API and MySQL container to Kubernetes.

This tutorial assumes you know about the basic principles of Docker and Kubernetes. If you do not you can check my previous articles on Docker and Kubernetes. Or check out this awesome video Kubernetes Architecture Explained. I will try to explain some terms as we go ahead.

Setting up Local Kubernetes using Docker Desktop

Install Docker. here.
Click on the Docker icon and go to the Preferences window as shown below. Click on the Kubernetes icon.
Check on the Enable Kubernetes option and then hit the Apply and Restart button as shown below:

This might take a whileeeee

You should see both Docker Desktop and Kubernetes running. You now have:
A standalone Kubernetes server and client.

Checking Out The Installation

A Node provides computing power to the Kubernetes system. In this case, your node is your computer system.
A cluster is a collection of nodes that share computing resources within themselves. Your Local Kubernetes server is a single-node cluster and is not configurable.
Pod- Kubernetes packages deployments into a higher-level structure called a pod. A pod is basically a collection of containers.

Execute the following commands from the terminal to check out your Kubernetes Installation.

$ kubectl version
Client Version: version.Info{Major:"1", Minor:"19", GitVersion:"v1.19.3", GitCommit:"1e11e4a2108024935ecfcb2912226cedeafd99df", GitTreeState:"clean", BuildDate:"2020-10-14T12:50:19Z", GoVersion:"go1.15.2", Compiler:"gc", Platform:"darwin/amd64"}
Server Version: version.Info{Major:"1", Minor:"19", GitVersion:"v1.19.3", GitCommit:"1e11e4a2108024935ecfcb2912226cedeafd99df", GitTreeState:"clean", BuildDate:"2020-10-14T12:41:49Z", GoVersion:"go1.15.2", Compiler:"gc", Platform:"linux/amd64"}

Check for the cluster-info

We have one cluster which automatically becomes our Kubernetes Master.

 $ kubectl cluster-info

Kubernetes master is running at https://kubernetes.docker.internal:6443
KubeDNS is running at https://kubernetes.docker.internal:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Check for the nodes in the cluster

$  kubectl get nodes
NAME             STATUS   ROLES    AGE   VERSION
docker-desktop   Ready    master   30m   v1.19.3

Installing the Kubernetes Dashboard

The Kubernetes Dashboard gives us a Visual representation of our Kubernetes system.
Run this command to install it.

$ kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.1.0/aio/deploy/recommended.yaml

namespace/kubernetes-dashboard created
serviceaccount/kubernetes-dashboard created
service/kubernetes-dashboard created
secret/kubernetes-dashboard-certs created

The Dashboard application will get deployed as a Pod in the Kube-system namespace. We can get a list of all our Pods in that namespace via the following command:

$  kubectl get pods --namespace=kube-system
NAME                                     READY   STATUS    RESTARTS   AGE
coredns-f9fd979d6-9f7mb                  1/1     Running   0          36m
coredns-f9fd979d6-bxlkw                  1/1     Running   0          36m
etcd-docker-desktop                      1/1     Running   0          35m
kube-apiserver-docker-desktop            1/1     Running   0          35m
kube-controller-manager-docker-desktop   1/1     Running   0          35m
kube-proxy-g8mwq                         1/1     Running   0          36m
kube-scheduler-docker-desktop            1/1     Running   0          35m
storage-provisioner                      1/1     Running   0          35m
vpnkit-controller                        1/1     Running   0          35m

Start your Dashboard Server with

$ kubectl proxy

Starting to serve on 127.0.0.1:8001

Open your Dashboard and navigate to
http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/#/login

If you get a 503 error just wait for about 5mins and refresh

You should see the authentication page for your dashboard.

Create a cluster-admin service account

You can create a service account with the cluster-admin role that will have access to all your resources.

Create a service account and call it (cluster-admin-dashboard-sa)

$ kubectl create serviceaccount cluster-admin-dashboard-sa


serviceaccount/cluster-admin-dashboard-sa created

Bind the service account to a cluster role as a cluster admin

$ kubectl create clusterrolebinding cluster-admin-dashboard-sa \
  --clusterrole=cluster-admin \
  --serviceaccount=default:cluster-admin-dashboard-sa

clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-dashboard-sa created

(cluster-admin-dashboard-sa) now has the privileges of a cluster-admin in Kubernetes.

Create a Token with the cluster-admin-dashboard-sa credentials.
To get the secret for creating the token run this command.

$ kubectl get secret | grep cluster-admin-dashboard-sa

cluster-admin-dashboard-sa-token-k95tz   kubernetes.io/service-account-token   3      9d

Get the Bearer Token

Remember to use your own token as generated from the cli.

$ kubectl describe secret cluster-admin-dashboard-sa-token-k95tz


Name:         cluster-admin-dashboard-sa-token-k75tz
Namespace:    default
Labels:       <none>
Annotations:  kubernetes.io/service-account.name: cluster-admin-dashboard-sa
              kubernetes.io/service-account.uid: 7055ee38-1bc6-4fe9-ac3d-075040cc4f3f

Type:  kubernetes.io/service-account-token

Data
====
ca.crt:     1025 bytes
namespace:  7 bytes
token:      eyJhbGciOiJSUzI1NiIsImtpZCI6IlQwY0prajRPYUttSzdEYU45RmUwQ3JEdG16VS1TbVZVRDRpS0lQLWZDU2cifQ.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJkZWZhdWx0Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZWNyZXQubmFtZSI6ImNsdXN0ZXItYWRtaW4tZGFzaGJvYXJkLXNhLXRva2VuLWs3NXR6Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImNsdXN0ZXItYWRtaW4tZGFzaGJvYXJkLXNhIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNzA1NWVlMzgtMWJjNi00ZmU5LWFjM2QtMDc1MDQwY2M0ZjNmIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OmRlZmF1bHQ6Y2x1c3Rlci1hZG1pbi1kYXNoYm9hcmQtc2EifQ.tS3fscFJAzzUuObtwq59A9PtADpeEyuJk1KnfAfWfFTmBMS5J9lcVv6wQfU1GY3a4pza062BLef8AG619zYIC4diY5yzXt1n5qjcXwdMGe_pCu-uDx-AWKRgWe744Jc7UF2mdJoavzy0ttIZN6eEiQVvCtK6bTiNe9GQIGsFwBm8H1JlW9TuZ8nFWrWgezkOb9FjgdamkLM8B8h302NiI--Coj3KL_eTPUvELJ0orZ7weaLmoqjHB7QgJyFXDzBZjqkiKdJu9I5vpPoRCwymPC9iujF42LrYUaPp-MuC3l6SCWgRDcvMPG1m1F1XA1uAHJn3UITPzMlCLCqbbuHMMA

Use the token to log into the dashboard.

You should see this.

Congratulations you have Successfully set up Kubernetes and configured your Kubernetes Dashboard on your Local System. In part 2 of this article, we will be deploying our Asp.Net Web Api and MySQL Container to Kubernetes. Check it out here

Blog