Kubernetes for Beginners: Nginx Deployment with Minikube

Discover how to deploy an Nginx 'Hello World' app in Kubernetes using Minikube - your first step into container orchestration."

Kubernetes for Beginners: Nginx Deployment with Minikube


Kubernetes is the go-to orchestration system for managing containerized applications across multiple hosts. It provides tools to deploy applications, scale them as needed, manage changes to existing containerized applications, and helps optimize the use of underlying hardware beneath your containers. Minikube is a tool that makes it easy to run Kubernetes locally. In this blog post, we'll walk through deploying a simple "Hello World" application using Nginx on Kubernetes with Minikube.


Before starting, ensure you have the following installed:

  • Docker, for creating container images and running containers.

  • Minikube, for a local Kubernetes cluster.

  • kubectl, the command-line tool for interacting with Kubernetes.

Step 1: Setting Up Minikube

Minikube simplifies the initial setup of a Kubernetes cluster:

minikube start

Verify that Minikube is properly set up by running:

minikube status

Step 2: Creating Your Nginx Container

Create a Dockerfile for your Nginx "Hello World" application.

FROM nginx:alpine
COPY ./index.html /usr/share/nginx/html/index.html

Here's a simple index.html to serve:

<!DOCTYPE html>
<title>Hello World</title>
<h1>Hello World from Nginx!</h1>

Build and tag the Docker image, then push it to your Docker registry

docker build -t hello-nginx:latest .

Note: If using Minikube's Docker daemon, you don't need to push the image to a registry.

Step 3: Writing the Kubernetes Deployment File

Create a deployment.yaml file that tells Kubernetes how to create and manage your application's instances.

apiVersion: apps/v1
kind: Deployment
  name: hello-nginx
  replicas: 2
      run: hello-nginx
        run: hello-nginx
      - name: hello-nginx
        image: hello-nginx:latest
        - containerPort: 80

Deploy your application to Kubernetes using kubectl.

kubectl apply -f deployment.yaml

Step 4: Accessing Your Application

To make your application accessible, expose it via a service.

kubectl expose deployment hello-nginx --type=NodePort --port=80

Retrieve the URL to access your Nginx application:

minikube service hello-nginx --url

Step 5: Scaling Your Deployment

You can easily scale the number of replicas in your deployment:

kubectl scale deployment hello-nginx --replicas=3

Check the status of your scaled deployment:

kubectl get deployment hello-nginx

Step 6: Cleaning Up

Once you are done, you can delete the service and deployment:

kubectl delete service hello-nginx

And stop Minikube with:

minikube stop


This guide provided a straightforward walkthrough for setting up a Kubernetes cluster with Minikube, deploying a simple "Hello World" Nginx application, and scaling it. Kubernetes’ ability to handle this deployment process showcases the power and flexibility of the platform. Whether you're a developer new to containerization or an operations engineer looking to automate your deployments, Kubernetes and Minikube together offer a robust toolset for managing containerized applications.

Local Development vs. Production Environments

It's important to note that Minikube is intended for local development, learning, and testing purposes. Its ease of setup and use provides a great sandbox for individuals to experiment with Kubernetes and understand its features without the overhead of a full-scale deployment.

For production environments, where reliability, scalability, and security are paramount, enterprise-grade solutions are recommended. Services like AWS Elastic Kubernetes Service (EKS), Google Kubernetes Engine (GKE), or Azure Kubernetes Service (AKS) offer managed Kubernetes experiences which handle much of the complexity and operational overhead. These services provide robust, scalable, and secure infrastructure to run your containerized applications in the cloud.

By starting with Minikube, you build a solid foundation that will aid in understanding how Kubernetes operates at a larger scale in a cloud environment. As you transition from a local to a production environment, you'll be able to appreciate the full potential of Kubernetes and how it can be leveraged to meet the demands of your applications and services.

Remember, the journey into Kubernetes is as rewarding as it is challenging. The skills you develop while managing and scaling your applications will be invaluable as you move towards cloud-native development and operations

Did you find this article valuable?

Support vishnu chilamakuru by becoming a sponsor. Any amount is appreciated!