Container Stress


The repository of this docs is on GitHub


This docs is not ready


Docker Image CI Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge

This is Stress test for container environments. This project work base on stress you can access the source on this link:

Build Dockerfile

we use alpine as the base image. for build Dockerfile Use:

$ docker build --tag=<DOCKER_IMAGE_NAME_TAG> .

Stress command

stress imposes certain types of compute stress on your system

Usage: stress [OPTION [ARG]] ...
-?, --help show this help statement
--version show version statement
-v, --verbose be verbose
-q, --quiet be quiet
-n, --dry-run show what would have been done
-t, --timeout N timeout after N seconds
--backoff N wait factor of N microseconds before work starts
-c, --cpu N spawn N workers spinning on sqrt()
-i, --io N spawn N workers spinning on sync()
-m, --vm N spawn N workers spinning on malloc()/free()
--vm-bytes B malloc B bytes per vm worker (default is 256MB)
--vm-stride B touch a byte every B bytes (default is 4096)
--vm-hang N sleep N secs before free (default none, 0 is inf)
--vm-keep redirty memory instead of freeing and reallocating
-d, --hdd N spawn N workers spinning on write()/unlink()
--hdd-bytes B write B bytes per hdd worker (default is 1GB)

Example: stress --cpu 8 --io 4 --vm 2 --vm-bytes 128M --timeout 10s

Note: Numbers may be suffixed with s,m,h,d,y (time) or B,K,M,G (size).

stress command examples :

stress --verbose --vm 1 --vm-bytes 256M
stress --verbose --vm 1 --vm-bytes 256M
stress --verbose --vm 1 --vm-bytes 512M
stress --verbose --vm 1 --vm-bytes 1024M
stress --verbose --vm 2 --vm-bytes 256M
stress --verbose --vm 2 --vm-bytes 512M
stress --verbose --vm 2 --vm-bytes 1024M

Run Stress test on single docker host

For test on single docker host you can use this command:

$ docker run --rm -it mohsenmottaghi/container-stress <COMMAND>


$ docker run --name stress -idt mohsenmottaghi/container-stress <COMMAND>

Run Stress test on Swarm cluster

For stress test on Swarm cluster, you can use the docker-compose.yml file.

  1. initialize the Swarm cluster or use your current cluster

  2. edit the docker-compose.yml with your specific command and replicas

  3. deploy stress stack with command like this:

    $ docker stack deploy -c docker-compose.yml <STACK_NAME>
  4. (Optional) you can use Docker viualizer

    $ docker service create \
    --name=viz \
    --publish=8080:8080/tcp \
    --constraint=node.role==manager \
    --mount=type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \

Run Stress test on Kubernetes Cluster

For stress test on kubernetes cluster, you need to deploy the Deployment yaml file.

$ kubectl apply -f stress-deployment.yml

To check the deployment status:

$ kubectl get deployment container-stress

or check all resources:

$ kubectl get all

To remove deployment:

$ kubectl delete deployment container-stress


$ kubectl delete -f stress-deployment.yml