perfkit-aws

What's inside?

Google's PerfKitBenchmarker configured and ready to run on AWS.

Why a Container?

You don't have to install anything on your local machine, clean and isolated in a Container ready to run.

How to use?

There are two options:

1.) pass your credentials als environment variable to docker.
2.) map your ~/.aws folder inside the container

Example with Environment Variables

You can find this script in the repository with the name run.sh:

#!/usr/bin/env bash

ACCESS_KEY_ID="your-access-key-here"
SECRET_ACCESS_KEY="your-secret-key-here"
DEFAULT_REGION="us-east-2"
DEFAULT_OUTPUT="json"

MACHINE_TYPE="t2.micro"
ZONE="us-east-2"
BENCHMARKS="iperf"

function main() {
  docker run \
    -it \
    -e AWS_ACCESS_KEY_ID="${ACCESS_KEY_ID}" \
    -e AWS_SECRET_ACCESS_KEY="${SECRET_ACCESS_KEY}" \
    -e AWS_DEFAULT_REGION="${DEFAULT_REGION}" \
    -e AWS_DEFAULT_OUTPUT="${DEFAULT_OUTPUT}" \
  ellerbrock/perfkit-aws \
    --cloud=AWS \
    --machine_type="${MACHINE_TYPE}" \
    --zones="${ZONE}" \
    --benchmarks="${BENCHMARKS}"
}

main

Example with .aws mapping

#!/usr/bin/env bash

MACHINE_TYPE="t2.micro"
ZONE="us-east-2"
BENCHMARKS="iperf"

function main() {
  docker run \
    -it \
    -v "${HOME}/.aws:/home/perfkit/.aws:ro" \
  ellerbrock/perfkit-aws \
    --cloud=AWS \
    --machine_type="${MACHINE_TYPE}" \
    --zones="${ZONE}" \
    --benchmarks="${BENCHMARKS}"
}

main

Contact