Installation

TestQC Web can be deployed using Docker on Linux and Mac, locally or on a host (server), as development environment or production server. This setup minimizes the risk of errors by automating all setup steps in a Dockerfile. Docker is a containerization platform that can be used to package and deploy applications. It runs natively on Linux and macOS. Please refer to the docker documentation for instructions on how to set it up on your platform.

There’s a ready made Dockerfile on repo source and can be build easily using LLB in buildkit :

docker buildx build --platform linux/amd64,linux/arm64 -t jfdesignnet/testqc .

and then start the container using following command :

docker-compose up

then you can access the application at https://< your-machine-ip >

Windows Installation
TestQC Web only distributed in Docker image, tested and package in private Container Registry under linux environment. For windows based installations you are on your own. I don’t know about windows, I never use winblows and will never gonna use it, so I cannot support it. Full stop. No strings attached.

Starting with Version 6.x, TestQC Web can also be deployed on a Kubernetes cluster for production runs. There is already a deployment manifest YAML available in the repo source and can be used to deploy to a Kubernetes cluster. The target is an on-premises Kubernetes cluster rather than a cloud-based cluster such as GCP, AWS or Azure.

This manifest is configured to run two replicas of pods for high availability (HA). It uses a NodePort with a ClusterIP, which allows you to access the service on a specific port on all nodes in the cluster using an internal load balancer. You can easily convert the manifest to use an external load balancer using Terraform as IaC if needed.

To deploy the manifest, run the following command:

kubectl apply -f testqc-deployment.yaml

Kubernetes will then assign a random high port (e.g., 30000-32767) on each node to your service. You can check the assigned port with the following command:

kubectl get svc testqc-service

To access your service, use any node’s IP address along with the assigned port. For example, if the assigned port is 31000 on a node with IP 192.168.1.100, you can access your service at http://192.168.1.100:31000.