Kubernetes Getting Started Guide

To start using your new ASERGO Kubernetes cluster, just follow these simple steps.

1. Create user accounts

Login to your Dashboard and create a user for each Kubernetes team member needed. Thereafter, go to the Dashboard Kubernetes config area, where you can download a pre-configured kubectl config file tailored to your cluster.

2. Setup your environment

If you do not have kubectl installed, you can follow the official guide .

Place the kubectl config file in the kubectl configuration folder on your computer.

To use ASERGO Dashboard OpenID Connect authentication for Kubernetes, you need to use a kubectl plugin called "kube-oidc". The easiest way to install it is by using a plugin-manager for kubectl. We recommend the Krew plugin-manager. To install Krew, you can follow the krew install guide .

3. Run your application

You now have access to your cluster and can start running your applications.

Your application may need storage, which can be added at any time. Each storage type has a corresponding storageClass with a naming scheme of:

  • asergo-rbd (block)
  • asergo-local (local)
  • asergo-obj (object)
  • asergo-file (file)

Conclusion

An ASERGO Kubernetes cluster behaves in the same way as other 100% standard Kubernetes clusters, including Minikube.

Create a namespace for the application:

$ kubectl create namespace my-new-app

Start your application in the namespace:

$ kubectl -n my-new-app apply -f https://asergo.com/knowledge-base/kubernetes/deploy/my-new-app-dp.yml

Check application rollout status:

$ kubectl -n my-new-app get deploy my-new-app-deployment
NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
my-new-app-deployment   1/1     1            1           3s

Scaling the application to run 5 replicas:

$ kubectl -n my-new-app scale deployment.v1.apps/my-new-app-deployment --replicas=5
deployment.apps/my-new-app-deployment scaled

$ Check application rollout status:

$ kubectl -n my-new-app get deploy my-new-app-deployment
NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
my-new-app-deployment   5/5     5            5           12m

Tail log of pod:

$ kubectl -n my-new-app logs -f my-new-app-deployment-689cb78dbd-6ff7l

Kubectl Kustomize Helm

We believe that Kubernetes should be managed by open-source tools only, and not by proprietary platforms.

With our Kubernetes clusters you can use the official upstream versions of both kubectl, Kustomize and helm.

Official kubectl cheat sheet