How to Deploy Docker Container to a Kubernetes Cluster

June 10, 2021

Containerization involves the packaging of code and its dependencies together. To better understand containerization with Docker and Kubernetes, this guide provides an example of developing a simple application, containerizing, and deploying it to a Kubernetes cluster.


You will need the following for the tutorial:

  1. A text editor to create the Flask application. I’ll be using VS Code.
  2. Docker Desktop installed on your computer.
  3. Kubernetes CLI installed.
  4. Minikube Installed in your computer. You call follow this guide for the installation procedure.

Understanding Docker & containers

Docker is an open-source containerization tool that packages applications into small units called containers. A Docker container image is a standalone software package that contains all the requirements for an application to run. 

Without Docker, a developer can send a running code to a tester, but upon running, the code might not run on the tester’s system. However, with Docker, an application is packaged with all the requirements and dependencies, hence a Docker container can run on any platform with Docker runtime.

What is Kubernetes?

Kubernetes assists in the orchestration of containerized applications to run on a cluster of hosts. It automates the deployment and management of Dockerized applications in cloud platforms. It levies the deployment team in the manual processes of deployment and scaling applications.

Creating the application

We will create a simple Flask application that generates random numbers and displays them on a webpage. To create the Flask app, we need to install flask.

In the directory of the project, run the command below:

pip install flask

Next, create two files requirements.txt to point to libraries and dependencies for and

Add the scripts below to the file:

from flask import Flask, render_template
import flask
app = Flask(__name__)

def index():
    return render_template('index.html')

if __name__ == '__main__':

Create a folder named templates which contains the HTML files rendered on the webpage. In the folder, create a file named index.html then add the snippets below.

<!DOCTYPE html>
<html lang="en">
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>Docker App</title>
        <link href="" rel="stylesheet">

        <nav class="navbar navbar-expand-lg navbar navbar-dark bg-success">
            <div class="container-fluid">
                <a class="navbar-brand" href="#">SECTION</a>
                <div class="collapse navbar-collapse" id="navbarSupportedContent">
                    <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <div class="container">
            <div class="card">
                <div class="card-header">
                    AWESOME ARTICLE
                <div class="card-body">
                    <h5 class="card-title">DEPLOY DOCKER CONTAINER TO KUBERNETES CLUSTER</h5>
                    <p class="card-text">
                        Docker is an open-source containerization tool that packages applications 
                        into small units called containers. 
                        A docker container image is a standalone software package that contains all 
                        the requirements for an application to run. 
                        Without docker, a developer can send a running code to a tester but upon running,                        the code might not run on the tester's system. 
                        However, with Docker, an app is packaged with all the requirements and dependencies hence a Docker container can run on any platform.
                    <a href="#" class="btn btn-success ">view article</a>

Requirements file

This file specifies the dependencies needed to run the application. In the root directory of the app, create a file named requirements.txt. Our application only requires flask and unicorn.

So we need to include the two in the requirements.txt file as below:


Creating a Dockerfile

The Dockerfile is used by the Docker engine to create a new Docker image of the application container. It sets up an environment needed to run the application.

Create a file called Dockerfile and add the snippets below:

# We need python 3.8
FROM python:3.8

# make the working directory in the container
RUN mkdir /app

# specify where to install the app

# add all files to the working directory
ADD . /app/

# Install the dependencies in the requirements file.
RUN pip install -r requirements.txt

# Run the app
CMD ["python", "/app/"]

Generating the application image

Startup the Docker desktop, then execute the command below:

    docker build --tag flask-test-app:latest .

Creating a Docker Image

Deploying the Docker image

Now that we have a Docker container image, we need to create a deployment file. In the root directory, create a new file called deployment.yaml. This file will deploy the application to the Kubernetes engine.

Add the following snippets to the file:

apiVersion: v1
kind: Service
  name: flask-test-service
    app: flask-test-app
  - protocol: "TCP"
    port: 6000
    targetPort: 5000
  type: LoadBalancer


apiVersion: apps/v1
kind: Deployment
  name: flask-test-app
      app: flask-test-app
  replicas: 5
        app: flask-test-app
      - name: flask-test-app
        image: flask-test-app
        imagePullPolicy: IfNotPresent
        - containerPort: 5000

The file has two parts:

  1. Service - The service acts as the load balancer. A load balancer is used to distribute requests to the various available servers.

  2. Deployment will act as the intended application. The user request hits the load balancer, then the load balancer distributes the request by creating the number of replicas defined in the deployment.yaml file. For example, in our case, we have five replicas for scalability, meaning that we will have 5 instances running at a time.

The benefit of multiple replicas is that if an instance crashes, the other application instances continue running.

The deployment.yaml file is connected to the Docker image created earlier, therefore to deploy the application to the Kubernetes cluster, we use the Docker image. The image will automatically create containers for the application when we deploy the application.

Deploying to Kubernetes service

We have dockerized our Flask application, and now we need to deploy it to a Kubernetes engine.

Execute the command below in your terminal:

kubectl apply -f deployment.yaml

This command will deploy our service and application instances to the Kubernetes engine. After executing this command, we should be able to see that the flask-test-service and the flask-test-app are created successfully.

Deploying to Kubernetes

The deployment dashboard

Minikube and Kubernetes provide a dashboard to visualize the deployment. To see our deployment in that dashboard, execute the command below in your terminal.

minikube dashboard

This command should yield a dashboard as shown below. 

Deployment dashboard

We can see that our Flask application was deployed and we can see the number of running instances. If a request is made, the load balancer distributes the number of hits the request had on the instances.

Accessing the application

We can access the application using the command below:

minikube start service: flask-test-service

This command will open the application in a browser as shown below:

Deployed app


In this tutorial, we created a web application using the Flask framework. We went ahead and created a Docker image of the application.

Finally, we successfully deployed the app to the Kubernetes cluster using Minikube.

This tutorial should help a beginner to get started with containerization using Docker containers and Kubernetes clusters.

You can find the source code for the application in this link.

Happy coding!

Peer Review Contributions by: Odhiambo Paul