ppearcy/selenium-locust-docker

selenium-locust

Based off of:

• https://github.com/greenbird/locust
• https://github.com/joyzoursky/docker-python-chromedriver

Installs tools to allow this to run against the locust helm chart to perform UI based testing.

A few gotchas:

• Headless chrome has bugs in realbrowserlocusts. Apply fixes here: https://github.com/nickboucart/realbrowserlocusts/issues/4
• Make sure to set resource allocations in helm chart, eg:

locust:
  image:
    repository: ppearcy/selenium-locust-docker
    tag: latest
  master:
    config:
      target-host: N/A
  worker:
    replicaCount: 1
    # Resource requests are very important for running selenium/chrome in kubernetes
    # Need to tune these to guarantee stability but not using too many resources
    resources:
      requests:
        cpu: 1000m
        memory: 1024Mi
      limits:
        cpu: 4000m
        memory: 4096Mi
    config:
      configmapName: locust-config-map

PREVIOUS README VERBATIM

Locust for Kubernetes

This reporitory is forked from the tutorial from Google on how to conduct distributed load testing using [***] We have removed the sample webapp and will only be focusing on maintaining an up to date Locust image for use in Helm Charts and other Kubernetes deployments.

In addition to the groundwork laid down by Google, we've merged updates from the https://github.com/honestbee/distributed-load-testing fork and built from there.

For instructions on how to use the Helm Chart to deploy to Kubernetes, we refer to https://github.com/helm/charts/tree/master/stable/locust. And for more background on this topic we refer to the http://cloud.google.com/solutions/distributed-load-testing-using-kubernetes solution paper.

Note: the image location includes the latest tag so that the image is pulled down every time a new Pod is launched. To use a Kubernetes-cached copy of the image, remove :latest from the image location.

Testing Locust locally

Locust can be tested locally using docker-compose as follows:

1. Start master and worker:

   docker-compose -p locust up -d
   

2. Verify master and worker logs:

   docker-compose -p locust logs
   

3. Open web console:

   open localhost:8089
   

4. Scale up workers:

   docker-compose -p locust scale worker=4
   

Shutting down local test.

docker-compose -p locust stop

License

This code is Apache 2.0 licensed and more information can be found in LICENSE. For information on licenses for third party software and libraries, refer to the docker-image/licenses directory.