WARNING: Pre-alpha. Do not use this in production. Only for testing.
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
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