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

aws-k8s-tester

aws-k8s-tester eks

To install

go install -v ./cmd/aws-k8s-tester
aws-k8s-tester eks create cluster -h

To create an EKS testing cluster with ALB Ingress Controller

aws-k8s-tester eks create config --path ./aws-k8s-tester-eks.yaml

# change default configurations
vi ./aws-k8s-tester-eks.yaml

aws-k8s-tester eks create cluster --path ./aws-k8s-tester-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 aws-k8s-tester-20180928-efeaantamazonco-Os0xhhKodH \
  --query cluster.status

"ACTIVE"

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

cat ./aws-k8s-tester-eks.yaml

Once complete, get the DNS names from ./aws-k8s-tester-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):

aws-k8s-tester eks delete cluster --path ./aws-k8s-tester-eks.yaml

aws-k8s-tester eks e2e tests

To test locally:

# set "AWS_K8S_TESTER_EKS_TAG" to avoid S3 bucket conflicts
# or just disable log uploads with "AWS_K8S_TESTER_EKS_UPLOAD_TESTER_LOGS=false"
cd ${GOPATH}/src/github.com/aws/aws-k8s-tester
AWS_K8S_TESTER_EKS_TEST_MODE=embedded \
  AWS_K8S_TESTER_EKS_KUBERNETES_VERSION=1.10 \
  AWS_K8S_TESTER_EKS_WAIT_BEFORE_DOWN=1m \
  AWS_K8S_TESTER_EKS_DOWN=true \
  AWS_K8S_TESTER_EKS_ENABLE_WORKER_NODE_HA=true \
  AWS_K8S_TESTER_EKS_ENABLE_NODE_SSH=true \
  AWS_K8S_TESTER_EKS_ENABLE_LOG_ACCESS=true \
  AWS_K8S_TESTER_EKS_UPLOAD_TESTER_LOGS=false \
  AWS_K8S_TESTER_EKS_UPLOAD_WORKER_NODE_LOGS=false \
  AWS_K8S_TESTER_EKS_WORKER_NODE_INSTANCE_TYPE=m3.xlarge \
  AWS_K8S_TESTER_EKS_WORKER_NODE_ASG_MIN=1 \
  AWS_K8S_TESTER_EKS_WORKER_NODE_ASG_MAX=1 \
  AWS_K8S_TESTER_EKS_ALB_ENABLE=true \
  AWS_K8S_TESTER_EKS_ALB_UPLOAD_TESTER_LOGS=false \
  AWS_K8S_TESTER_EKS_ALB_TARGET_TYPE=ip \
  AWS_K8S_TESTER_EKS_ALB_TEST_MODE=nginx \
  AWS_K8S_TESTER_EKS_ALB_TEST_SCALABILITY=true \
  AWS_K8S_TESTER_EKS_ALB_TEST_SCALABILITY_MINUTES=3 \
  AWS_K8S_TESTER_EKS_ALB_TEST_METRICS=true \
  AWS_K8S_TESTER_EKS_ALB_TEST_SERVER_REPLICAS=3 \
  AWS_K8S_TESTER_EKS_ALB_TEST_SERVER_ROUTES=1 \
  AWS_K8S_TESTER_EKS_ALB_TEST_CLIENTS=200 \
  AWS_K8S_TESTER_EKS_ALB_TEST_RESPONSE_SIZE=20000 \
  AWS_K8S_TESTER_EKS_ALB_TEST_CLIENT_ERROR_THRESHOLD=500 \
  AWS_K8S_TESTER_EKS_ALB_TEST_EXPECT_QPS=100 \
  AWS_K8S_TESTER_EKS_ALB_INGRESS_CONTROLLER_IMAGE=quay.io/coreos/alb-ingress-controller:1.0-beta.7 \
  ./tests/ginkgo.sh