{"id":5481,"date":"2026-10-27T10:50:25","date_gmt":"2026-10-27T10:50:25","guid":{"rendered":"https:\/\/geekmungus.co.uk\/?p=5481"},"modified":"2026-10-27T10:50:25","modified_gmt":"2026-10-27T10:50:25","slug":"kubernetes-test-lab-part-3-using-docker-to-create-container-image-and-deploy","status":"publish","type":"post","link":"https:\/\/geekmungus.co.uk\/?p=5481","title":{"rendered":"Kubernetes Test Lab – Part 3 – Using Docker to Create Container Image and Deploy"},"content":{"rendered":"\n

We’re using Containerd for to run the containers within our Kubernetes environment. But if we want to quickly spin up some containers for testing, or more likely create our own container images, we can use Docker. Before we can start to create our own container images, we need to install Docker and then register it with a DockerHub account, so we can push our created images to DockerHub, to then start up on our Kubernetes cluster.<\/p>\n\n\n\n

We’re going to do a simple example where we’ll create a Container Image with NGINX, and a custom index.html page to make it obvious the container has indeed been customised somewhat.<\/p>\n\n\n\n

Install Docker (Option 1)<\/h1>\n\n\n\n

On our Management Workstation we’ll install Docker, so we’ll install it using the following:<\/p>\n\n\n\n

sudo apt update\nsudo apt install docker.io -y\n\nsudo systemctl enable docker\nsudo systemctl start docker<\/code><\/pre>\n\n\n\n
Configure for Run as Non-Root User<\/h2>\n\n\n\n
To ensure you can run as a non-root user, this will add your current user designated by the $USER environment variable to the group “docker”.<\/p>\n\n\n\n
sudo groupadd docker\nsudo usermod -aG docker $USER<\/code><\/pre>\n\n\n\n
Now you can either log out of your session and back in again, or you may be able to run the following to force Linux to reenumerate your user’s group membership.<\/p>\n\n\n\n
newgrp docker<\/code><\/pre>\n\n\n\n
Verify and Test<\/h2>\n\n\n\n
Verify you can indeed run as as a non-root user:<\/p>\n\n\n\n
docker run hello-world<\/code><\/pre>\n\n\n\n
If you get an output, that shows you can successfully run docker containers under your normal user account.<\/p>\n\n\n\n
Install Docker (Option 2)<\/h1>\n\n\n\n
Add Docker’s official GPG key:<\/p>\n\n\n\n
sudo apt update\nsudo apt install ca-certificates curl\nsudo install -m 0755 -d \/etc\/apt\/keyrings\nsudo curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg -o \/etc\/apt\/keyrings\/docker.asc\nsudo chmod a+r \/etc\/apt\/keyrings\/docker.asc<\/code><\/pre>\n\n\n\n
Add the repository to APT sources:<\/p>\n\n\n\n
sudo tee \/etc\/apt\/sources.list.d\/docker.sources <<EOF\nTypes: deb\nURIs: https:\/\/download.docker.com\/linux\/ubuntu\nSuites: $(. \/etc\/os-release && echo \"${UBUNTU_CODENAME:-$VERSION_CODENAME}\")\nComponents: stable\nArchitectures: $(dpkg --print-architecture)\nSigned-By: \/etc\/apt\/keyrings\/docker.asc\nEOF\n\nsudo apt update<\/code><\/pre>\n\n\n\n
Now install Docker, we’re going to use the latest version, see the Docker documentation about the installation of a specific version if you so require a specific version.<\/p>\n\n\n\n
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin<\/code><\/pre>\n\n\n\n
Once installed, check it is running with the following and required start it.<\/p>\n\n\n\n
sudo systemctl status docker\nsudo systemctl start docker<\/code><\/pre>\n\n\n\n
Configure for Run as Non-Root User<\/h2>\n\n\n\n
To ensure you can run as a non-root user, this will add your current user designated by the $USER environment variable to the group “docker”.<\/p>\n\n\n\n
sudo groupadd docker\nsudo usermod -aG docker $USER<\/code><\/pre>\n\n\n\n
Now you can either log out of your session and back in again, or you may be able to run the following to force Linux to renumerate your user’s group membership.<\/p>\n\n\n\n
newgrp docker<\/code><\/pre>\n\n\n\n
Verify and Test<\/h2>\n\n\n\n
Verify you can indeed run as as a non-root user:<\/p>\n\n\n\n
docker run hello-world<\/code><\/pre>\n\n\n\n
If you get an output, that shows you can successfully run docker containers under your normal user account.<\/p>\n\n\n\n
Login to DockerHub Account<\/h1>\n\n\n\n
If you were to create a new Container Image and then build it. The docker image is only stored in our local Docker repository on this Management Workstation, if we want to use this Docker image elsewhere we can, but we need to push it up to our DockerHub.<\/p>\n\n\n\n
I’m assuming you have a DockerHub account already setup, so we’ll now connect it up from the Management Workstation.<\/p>\n\n\n\n
cd ~\ndocker login -u <username><\/code><\/pre>\n\n\n\n
When prompted, you’ll want to create a PAT instead. Login to the web interface, under the Profile Settings, see Personal Access Tokens, and generate one, giving it a suitable name. I’m setting it to be Read, Write, Delete<\/strong>.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Paste the generated PAT into the password prompt on the command line.<\/p>\n\n\n\n
All being well you should now find you are logged in:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
You should now be ready to push your image to the DockerHub.<\/p>\n\n\n\n
Create and Build a Container Image<\/h1>\n\n\n\n
You may want to have a Git repository cloned to your Development Workstation to store all your Dockerfile definitions in.<\/p>\n\n\n\n
Create Dockerfile Definition and Content<\/h2>\n\n\n\n
We’ll create a simple NGINX image, so we first create a directory to hold the Docker files and another directory within that called “nginx-custom” which will actually hold the Dockerfile and our customised index.html file.<\/p>\n\n\n\n
mkdir docker\ncd docker\nmkdir nginx-custom<\/code><\/pre>\n\n\n\n
Create two files as follows:<\/p>\n\n\n\n
Dockerfile<\/strong><\/p>\n\n\n\n
FROM nginx:1.27.0\n\nRUN apt-get update\nRUN apt-get install vim -y\n\nCOPY index.html \/usr\/share\/nginx\/html\/index.html\nRUN chown nginx:nginx \/usr\/share\/nginx\/html\/index.html<\/code><\/pre>\n\n\n\n
index.html<\/strong><\/p>\n\n\n\n
<!DOCTYPE html>\n<html>\n<head>\n<title>Welcome to nginx!<\/title>\n<style>\nhtml { color-scheme: light dark; }\nbody { width: 35em; margin: 0 auto;\nfont-family: Tahoma, Verdana, Arial, sans-serif; }\n<\/style>\n<\/head>\n<body>\n<h1>Welcome to NGINX!<\/h1>\n<p>Wellcome to NGINX! This is a customised default image, with a replaced index.html file.<\/p>\n<\/body>\n<\/html><\/code><\/pre>\n\n\n\n
Build Image<\/h2>\n\n\n\n
We build an image based on a Dockerfile manifest we just created:<\/p>\n\n\n\n
docker build -t geekmungus\/nginx-custom:v1.0.0 .<\/code><\/pre>\n\n\n\n
Check that the Container Image is now within the local Docker image repository with:<\/p>\n\n\n\n
docker image ls<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Lovely, so now we have it, let’s quickly try to run it locally, before we push the image to DockerHub.<\/p>\n\n\n\n
Verify and Test<\/h2>\n\n\n\n
Let’s quickly test it works and give us the result we expect with the following, this will automatically remove the container when stopped, so we don’t have to clean it up.<\/p>\n\n\n\n
docker run --rm -d --name nginx-custom -p 80:80 geekmungus\/nginx-custom:v1.0.0<\/code><\/pre>\n\n\n\n
The container will now be running and listening on Port 80. To verify it works as expected, we CURL for the http:\/\/localhost<\/a> (i.e. port 80).<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Push Container Image to DockerHub<\/h1>\n\n\n\n
Let’s push the image we just created up to the DockerHub, we’re already logged into DockerHub, so all we need to do is…<\/p>\n\n\n\n
docker push geekmungus\/nginx-custom:v1.0.0<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
The image is now pushed to DockerHub, depending on the privacy settings of your DockerHub repositories, its now visible and able to be pulled by the Kubernetes Cluster to its own image registry, so it is able to run this image, we’ll try that in a moment.<\/p>\n\n\n\n
Use Customised Image (from Repository) in Kubernetes Deployment<\/h1>\n\n\n\n
So now we have pushed our customised image to DockerHub. We can now actually deploy our application onto our Kubernetes environment. We first need to create a Kubernetes manifest file and apply it.<\/p>\n\n\n\n
Notice that within the “containers” section of the specification, the “image” is set to “geekmungus\/nginx-custom:v1.0.0”, thus specifying the container image we just created and tested (with Docker) a few moments ago.<\/p>\n\n\n\n
nginx-custom-simple.yaml<\/strong><\/p>\n\n\n\n
# Deployment Definition\napiVersion: apps\/v1\nkind: Deployment\nmetadata:\n  name: nginx-custom\n  labels:\n    app: nginx-custom\nspec:\n  replicas: 1\n  selector:\n    matchLabels:\n      app: nginx-custom\n  template:\n    metadata:\n      labels:\n        app: nginx-custom\n    spec:\n      containers:\n        - name: nginx-custom\n          image: geekmungus\/nginx-custom:v1.0.0\n          ports:\n            - containerPort: 80\n          resources:\n            requests:\n              cpu: 256m\n              memory: 128Mi\n            limits:\n              cpu: 512m\n              memory: 256Mi\n---\n# Service Definition\napiVersion: v1\nkind: Service\nmetadata:\n  name: nginx-custom-service\n  labels:\n    app: nginx-custom\nspec: \n  type: LoadBalancer\n  allocateLoadBalancerNodePorts: true # Requires a redeploy to add or remove.\n  selector:\n    app: nginx-custom\n  ports:\n  - port: 80\n    targetPort: 80<\/code><\/pre>\n\n\n\n
Now we apply it as follows:<\/p>\n\n\n\n
kubectl apply -f nginx-custom-simple.yaml<\/code><\/pre>\n\n\n\n
We can then check it is running as expected with:<\/p>\n\n\n\n
kubectl get pods,svc<\/code><\/pre>\n\n\n\n
And as we can see in the output below, we can see the “nginx-custom-service” which has a LoadBalancer and an external IP address 192.168.101.161 (in this example). Ignore the other things running.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
If we now try to access the service with CURL, we can indeed see its running our customised image.<\/p>\n\n\n\n
curl http:\/\/192.168.101.161<\/code><\/pre>\n\n\n\n
We can indeed see our customised image has been used and is indeed running.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Conclusion<\/h1>\n\n\n\n
Although a simple example, the above gives you the flavour of the kind of approach you need to take when you build and deploy an application to your Kubernetes cluster. Although in the real world you would have built and configured an automated process for this, so that you would be able to create, test and deploy images within some form of a pipeline so that manual steps would not be required.<\/p>\n\n\n\n
With the basis of the above, we are now good to begin to move onto our topics within the series.<\/p>\n\n\n\n
Additional Information\/Further Reading<\/h1>\n\n\n\n