kubetest2-ec2

kubetest2-ec2

Kubetest2 is a framework for deploying Kubernetes clusters and running end-to-end tests against them.

kubetest2-ec2 is a deployer for kubetest2 to deploy a kubeadm based cluster on EC2 nodes. kubetest2-ec2 manages the lifecycle of a temporary Kubernetes cluster for testing. kubetest2-ec2 uses ubuntu images to install and run the kubernetes cluster.

Installation

To install kubetest2-ec2: go install sigs.k8s.io/provider-aws-test-infra/kubetest2-ec2@latest

You will need kubetest2 itself and kubetest2-ginkgo (a tester) to be able to run a test.

Usage

General usage is of the form:

kubetest2 <deployer> [Flags] [DeployerFlags] -- [TesterArgs]

Example: list all flags for the ec2 deployer and ginkgo tester

kubetest2 ec2 --test=ginkgo --help

Example: deploy a cluster using a local checkout of kubernetes/kubernetes, run Conformance tests

kubetest2 ec2 \
 --repo-root $HOME/go/src/k8s.io/kubernetes \
 --region us-east-1 \
 --target-build-arch linux/amd64 \
 --stage provider-aws-test-infra \
 --build \
 --up \
 --down \
 --test=ginkgo \
 -- \
 --focus-regex='\[Conformance\]'

if --build is not specified then kubetest2 skips that phase. if --down is not specified, kubetest2 leaves the cluster up and running for further inspection. --test is need to actually run the test. you can use either --focus-regex to run specific tests and/or --skip-regex to skip some.

Here is a slightly different example:

kubetest2 ec2 \
 --region=us-east-1 \
 --stage provider-aws-test-infra \
 --target-build-arch linux/arm64 \
  --build \
 --up \
 --test=ginkgo \
 -- \
 --use-built-binaries true \
 --skip-regex='\[Driver:.gcepd\]|\[Slow\]|\[Serial\]|\[Disruptive\]|\[Flaky\]|\[Feature:.+\]' \
 --ginkgo-parallel=30

Here's the simplest example that builds and stands up a cluster:

kubetest2 ec2 \
 --stage dims-aws-test-infra \
 --build \
 --up

Instead of building, pushing to s3 buckets and then standing up a cluster from there, you can use release artifacts directly as well, like so:

kubetest2 ec2 \
  --stage https://dl.k8s.io/ \
  --version v1.28.0 \
  --up

So you can see that a lot of things have defaults and/or picked up from the environment (like the AWS credentials)

Some important CLI parameters are:

Reference Implementations

See individual READMEs for more information

Contact

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

• Slack
• Mailing List

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.