Mahira Technology Private Limited's Blog

Deploying a Sample Nginx App on Kubernetes Cluster: The Secret to Boosting Your DevOps Skills!

Mahira Technology Private Limited's photo
Mahira Technology Private Limited
·

4 min read

Introduction :-

Remember the days when deploying applications was a tiresome task, filled with manual steps and prone to errors? Oh, how times have changed! Kubernetes has come to the forefront as a powerful container orchestration tool, making our lives significantly easier. Today, we’ll tackle how to deploy an Nginx application on a Kubernetes cluster. This isn’t just about learning a new skill; it’s about stepping closer to mastering Kubernetes. Ready to jump in?

Pre-requisites :-

Before we dive deep, let’s ensure we’re all set with the basics:

  • Kubernetes Cluster: Having a functioning Kubernetes cluster is the first step. If you’re just testing, Minikube on your local machine is a great starting point.

  • kubectl: This is the command-line tool that lets you interact with your Kubernetes cluster. Make sure it’s installed and configured.

  • Docker: Since we’re dealing with containers, Docker needs to be part of your toolkit.

  • Basic understanding of Docker and Kubernetes: Familiarity with basic concepts and commands of Docker and Kubernetes will be super helpful.

Procedure :-

Let’s break down the process into manageable steps -

Setting the Stage for Your Nginx Deployment

Initiating an Nginx deployment begins with crafting a precise Kubernetes deployment configuration. The cornerstone of this setup is the deployment YAML file. This configuration not only outlines the deployment’s desired state, including the number of replicas and container specifications but also ties your deployment to the Nginx image. Here’s how you start:

Create a file named deployment.yaml with the following content:

#deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        ports:
        - containerPort: 80

Bringing Your Deployment to Life

With the deployment YAML file set, apply it to your Kubernetes cluster using the following command:

kubectl apply -f deployment.yaml

To verify the deployment’s success and check that it’s up and running, issue the command:

kubectl get deployments

You should observe output similar to:

NAME               READY   UP-TO-DATE   AVAILABLE   AGE
nginx-deployment   2/2     2            2           29s

This confirms the successful launch of your Nginx deployment, underscored by the creation of two replicas.

Ensuring Your Nginx Deployment is Operational

Verification is key. For Nginx, ensuring it’s operational means checking that it’s serving content on port 80. Achieve this by identifying the IP addresses of your deployed pods with:

kubectl get pods -o wide

You might encounter output resembling:

NAME                                READY   STATUS     RESTARTS   AGE     IP            NODE       NOMINATED NODE   READINESS GATES
nginx-deployment-57d84f57dc-6wk4h   1/1     Running    0          3m22s   10.244.0.10   minikube   <none>           <none>
...

Note the pod IP and test the Nginx server’s responsiveness via:

curl 10.244.0.10

If you get an output like this:

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
<style>
html { color-scheme: light dark; }
body { width: 35em; margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif; }
</style>
</head>
<body>
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>
<p>For online documentation and support please refer to
<a href="http://nginx.org/">nginx.org</a>.<br/>
Commercial support is available at
<a href="http://nginx.com/">nginx.com</a>.</p>
<p><em>Thank you for using nginx.</em></p>
</body>
</html>

An affirmative Nginx welcome page response signals a successful deployment onto your Kubernetes cluster, confirming your Nginx service is operationally sound across the pods.

Expanding Reach with a LoadBalancer Service

To make your Nginx server accessible beyond the cluster, integrating a LoadBalancer service extends its reach. Apply the following configuration through a load-balancer.yaml file:

#load-balancer.yaml
apiVersion: v1
kind: Service
metadata:
  name: nginx-load-balancer
spec:
  selector:
    app: nginx
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80
  type: LoadBalancer

Apply it with:

kubectl apply -f load-balancer.yaml

And you should see an Nginx default page in your IP address.

Conclusion :-

Congratulations! You’ve just deployed your first application on a Kubernetes cluster. Feels good, doesn’t it? By breaking down the process into understandable chunks, I hope you’ve realized that Kubernetes is not as complex as it might seem. As you dive deeper, you’ll find a vibrant community and a wealth of resources to help you along your journey.

Remember, every DevOps expert started somewhere, and deploying your first application is a big step in the right direction. Keep exploring, experimenting, and learning. The sky’s the limit, and your newfound Kubernetes skills are now a powerful arrow in your DevOps quiver

KubernetesDevopsbest practicesnginxdeploymentappclusterminikubekubernetes architecture