README
¶
WARNING: Pre-alpha. Do not use this in production. Only for testing.
aws-k8s-tester
aws-k8s-tester is a set of utilities and libraries for testing Kubernetes on AWS.
Install
https://github.com/aws/aws-k8s-tester/releases
aws-k8s-tester eks
Make sure AWS credential is located in your machine:
cat ~/.aws/credentials
# confirm credential is valid
aws sts get-caller-identity --query Arn --output text
aws-k8s-tester eks create cluster -h
aws-k8s-tester eks create config --path /tmp/config.yaml
aws-k8s-tester eks create cluster --path /tmp/config.yaml
This will create an EKS cluster with a worker node (takes about 20 minutes).
Once cluster is created, check cluster state using AWS CLI:
aws eks describe-cluster \
--name [NAME] \
--query cluster.status
"ACTIVE"
Cluster states are persisted on disk as well. EKS tester uses this file to track status.
cat /tmp/config.yaml
# or
less +FG /tmp/config.yaml
Tear down the cluster (takes about 10 minutes):
aws-k8s-tester eks delete cluster --path /tmp/config.yaml
Directories
¶
| Path | Synopsis |
|---|---|
|
client
module
|
|
|
cmd
|
|
|
aws-k8s-tester
aws-k8s-tester is a set of AWS test commands.
|
aws-k8s-tester is a set of AWS test commands. |
|
aws-k8s-tester/ec2
Package ec2 implements EC2 related commands.
|
Package ec2 implements EC2 related commands. |
|
aws-k8s-tester/eks
Package eks implements EKS related commands.
|
Package eks implements EKS related commands. |
|
aws-k8s-tester/version
Package version implements version command.
|
Package version implements version command. |
|
e2e
|
|
|
tester
Module
|
|
|
e2e2
module
|
|
|
Package ec2 implements testing utilities using EC2.
|
Package ec2 implements testing utilities using EC2. |
|
Package ec2config defines EC2 configuration.
|
Package ec2config defines EC2 configuration. |
|
Package eks implements EKS cluster operations.
|
Package eks implements EKS cluster operations. |
|
alb
Package alb implements ALB plugin that installs 2048.
|
Package alb implements ALB plugin that installs 2048. |
|
cronjobs
Package cronjobs creates CronJob objects in Kubernetes.
|
Package cronjobs creates CronJob objects in Kubernetes. |
|
example
example shows how to use "eks" package.
|
example shows how to use "eks" package. |
|
fargate
Package fargate implements tester for Fargate.
|
Package fargate implements tester for Fargate. |
|
gpu
Package gpu implements GPU plugin.
|
Package gpu implements GPU plugin. |
|
irsa
Package irsa implements tester for IAM Roles for Service Accounts (IRSA).
|
Package irsa implements tester for IAM Roles for Service Accounts (IRSA). |
|
jobs-echo
Package jobsecho creates Job objects in Kubernetes.
|
Package jobsecho creates Job objects in Kubernetes. |
|
jobs-pi
Package jobspi creates example Job objects in Kubernetes.
|
Package jobspi creates example Job objects in Kubernetes. |
|
mng
Package mng defines AWS EKS Managed Node Group configuration.
|
Package mng defines AWS EKS Managed Node Group configuration. |
|
nlb
Package nlb implements NLB plugin.
|
Package nlb implements NLB plugin. |
|
secrets
Package secrets implements Secrets plugin.
|
Package secrets implements Secrets plugin. |
|
Package eksconfig defines EKS test configuration.
|
Package eksconfig defines EKS test configuration. |
|
Package ekstester defines interface EKS cluster tester and deployer.
|
Package ekstester defines interface EKS cluster tester and deployer. |
|
k8s-tester
module
|
|
|
aqua
Module
|
|
|
armory
Module
|
|
|
cloudwatch-agent
Module
|
|
|
clusterloader
Module
|
|
|
cmd/k8s-tester
Module
|
|
|
cmd/readme-gen
Module
|
|
|
cni
Module
|
|
|
configmaps
Module
|
|
|
conformance
Module
|
|
|
csi-ebs
Module
|
|
|
csi-efs
Module
|
|
|
csrs
Module
|
|
|
epsagon
Module
|
|
|
falco
Module
|
|
|
falcon
Module
|
|
|
fluent-bit
Module
|
|
|
helm
Module
|
|
|
jobs-echo
Module
|
|
|
jobs-pi
Module
|
|
|
kubecost
Module
|
|
|
kubernetes-dashboard
Module
|
|
|
metrics-server
Module
|
|
|
nlb-guestbook
Module
|
|
|
nlb-hello-world
Module
|
|
|
php-apache
Module
|
|
|
secrets
Module
|
|
|
splunk
Module
|
|
|
stress
Module
|
|
|
sysdig
Module
|
|
|
tester
Module
|
|
|
vault
Module
|
|
|
wordpress
Module
|
|
|
kubetest2
module
|
|
|
pkg
|
|
|
aws
Package aws implements wrappers for AWS API calls.
|
Package aws implements wrappers for AWS API calls. |
|
aws/cloudformation
Package cloudformation implements common CloudFormation utilities.
|
Package cloudformation implements common CloudFormation utilities. |
|
aws/ec2
Package ec2 implements various AWS EC2 operations.
|
Package ec2 implements various AWS EC2 operations. |
|
aws/ec2/instance-types
instance-types auto-generates EC2 instance types from AWS API.
|
instance-types auto-generates EC2 instance types from AWS API. |
|
aws/ec2/metadata
Package metadata queries the EC2 metadata.
|
Package metadata queries the EC2 metadata. |
|
aws/elb
Package elb implements ELB utilities.
|
Package elb implements ELB utilities. |
|
aws/iam
Package iam implements various IAM components.
|
Package iam implements various IAM components. |
|
ctxhandler
Package ctxhandler implements context handler.
|
Package ctxhandler implements context handler. |
|
fileutil
Package fileutil implements file utilities.
|
Package fileutil implements file utilities. |
|
httputil
Package httputil implements various HTTP operations.
|
Package httputil implements various HTTP operations. |
|
logutil
Package logutil implements various log utilities.
|
Package logutil implements various log utilities. |
|
Package ssh implements various SSH commands.
|
Package ssh implements various SSH commands. |
|
utils
module
|
|
|
Package version defines aws-k8s-tester version.
|
Package version defines aws-k8s-tester version. |
Click to show internal directories.
Click to hide internal directories.