WARNING: Pre-alpha. Do not use this in production. Only for testing.

awstester

awstester eks

To install

go install -v ./cmd/awstester
awstester eks create cluster -h

To create an EKS testing cluster with ALB Ingress Controller

awstester eks create config --path ./awstester-eks.yaml

# change default configurations
vi ./awstester-eks.yaml

awstester eks create cluster --path ./awstester-eks.yaml

This will create an EKS cluster with ALB Ingress Controller (takes about 20 minutes).

Once cluster is created, check cluster state using AWS CLI:

aws eks describe-cluster \
  --name awstester-20180928-efeaantamazonco-Os0xhhKodH \
  --query cluster.status

"ACTIVE"

Cluser states are persisted on disk as well. EKS tester uses this file to track status.

cat ./awstester-eks.yaml

Once complete, get the DNS names from ./awstester-eks.yaml.

And curl the kube-system namespace's /metrics endpoint, to see if it works.

# for example
curl -L http://e5de0f6b-kubesystem-ingres-6aec-38954145.us-west-2.elb.amazonaws.com/metrics

Tear down the cluster (takes about 10 minutes):

awstester eks delete cluster --path ./awstester-eks.yaml

awstester eks e2e tests

To run locally:

aws ecr create-repository --repository-name awstester
aws ecr list-images --repository-name awstester

cd ${GOPATH}/src/github.com/aws/awstester
go install -v ./cmd/awstester

cd ${GOPATH}/src/github.com/aws/awstester
./scripts/awstester.build.container.push.sh


cd ${GOPATH}/src/github.com/aws/awstester

AWSTESTER_EKS_KUBETEST_EMBEDDED_BINARY=true \
  AWSTESTER_EKS_WAIT_BEFORE_DOWN=1m \
  AWSTESTER_EKS_DOWN=true \
  AWSTESTER_EKS_ENABLE_NODE_SSH=true \
  AWSTESTER_EKS_AWSTESTER_IMAGE=[ACCOUNT_ID].dkr.ecr.us-west-2.amazonaws.com/awstester:[TAG] \
  AWSTESTER_EKS_WORKER_NODE_INSTANCE_TYPE=c5.xlarge \
  AWSTESTER_EKS_WORKER_NODE_ASG_MIN=5 \
  AWSTESTER_EKS_WORKER_NODE_ASG_MAX=5 \
  AWSTESTER_EKS_ALB_ENABLE=true \
  AWSTESTER_EKS_ALB_TARGET_TYPE=instance \
  AWSTESTER_EKS_ALB_TEST_MODE=nginx \
  AWSTESTER_EKS_ALB_TEST_SCALABILITY=false \
  AWSTESTER_EKS_ALB_TEST_SERVER_REPLICAS=5 \
  AWSTESTER_EKS_ALB_TEST_SERVER_ROUTES=3 \
  AWSTESTER_EKS_ALB_TEST_CLIENTS=200 \
  AWSTESTER_EKS_ALB_TEST_CLIENT_REQUESTS=20000 \
  AWSTESTER_EKS_ALB_TEST_RESPONSE_SIZE=40960 \
  AWSTESTER_EKS_ALB_TEST_CLIENT_ERROR_THRESHOLD=10 \
  AWSTESTER_EKS_ALB_TEST_EXPECT_QPS=300 \
  AWSTESTER_EKS_ALB_ALB_INGRESS_CONTROLLER_IMAGE=quay.io/coreos/alb-ingress-controller:1.0-beta.7 \
  ./tests/ginkgo.sh