Go Loadtest API

Simple program, written in Go, to generate CPU load thru a RESTFul Web API.

DockerHub Automated Builds

This repository's Docker image is linked to DockerHub registry jmb12686/go-loadtest-api. Every commit to the master branch on GitHub triggers a DockerHub Automated Build, simplifying the image publishing process by eliminating the need to manually images to a registry.

How to Build Locally

Building and compiling the program is easiest by using Docker. The included Dockerfile is a multi-stage build: https://docs.docker.com/develop/develop-images/multistage-build/

To build:

git clone https://github.com/jmb12686/go-loadtest-api.git
cd go-loadtest-api
docker build -t go-loadtest-api .

How to Run

Assuming you built the docker image using the above command, you can use the following command to run:

docker run --rm -p 8000:8000 --name go-loadtest-api go-loadtest-api

Program API Usage

The following APIs are usable from the program

Hello endpoint

http://localhost:8000/hello

CPU Loadtest endpoint

http://localhost:8000/loadtest/iterations/$NUM_ITERATIONS