Quickstart

This page explains how to get a load test started quickly:

Step 1: Clone this repository and open the example load test project:

$ git clone [email protected]:electronicarts/gatling-aws-maven-plugin.git
$ cd examples/maven-example-loadtest-project

Step 2: Try running the example load test script provided src/test/scala/com/ea/gatling/example/Loadtest.scala.

$ ./runLoadtestLocally.sh

Step 3: Create an AWS access/secret key that can be used by Gatling and add it to aws.properties.

Step 4: Create an S3 bucket for your load test results. I will assume you called this loadtest-results.

Step 5: Create an EC2 security group for Gatling. This document assumes you called this default.

Step 6: Create an EC2 key pair for Gatling. This document assumes you called this loadtest-keypair. Store the .pem file in ${user.home}/.ssh/loadtest.pem.

Step 7: Attach sufficient permissions to the IAM account associated with Gatling's access/secret key. Replace the loadtest-results S3 bucket with the bucket name you have chosen.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:RunInstances",
        "ec2:StopInstances",
        "ec2:CreateTags",
        "ec2:TerminateInstances",
        "ec2:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "autoscaling:Describe*",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "s3:*",
      "Resource": "arn:aws:s3:::loadtest-results/*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:Get*",
        "s3:List*"
      ],
      "Resource": "*"
    }
  ]
}

Step 9: Try to run your load test on EC2.

./downloadGatling.sh 
./runLoadtestRemotely.sh