README
¶
kubetest2
Kubetest2 is the framework for launching and running end-to-end tests on Kubernetes. It is intended to be the next significant iteration of kubetest.
Installation
To install core and all deployers and testers:
GO111MODULE=on go get sigs.k8s.io/kubetest2/...@latest
To install a specific deployer:
GO111MODULE=on go get sigs.k8s.io/kubetest2/kubetest2-DEPLOYER@latest (DEPLOYER can be gce, gke, etc.)
To install a sepcific tester:
GO111MODULE=on go get sigs.k8s.io/kubetest2/kubetest2-tester-TESTER@latest (TESTER can be ginkgo, exec, etc.)
Usage
An example run of the Ginkgo conformance suite against your local version of the k/k repo deployed to GCE looks as follows:
kubetest2 gce -v 2 \
--repo-root $KK_REPO_ROOT \
--gcp-project $YOUR_GCP_PROJECT \
--legacy-mode \
--build \
--up \
--down \
--test=ginkgo \
-- \
--focus-regex='\[Conformance\]'
See READMEs specific to each deployer and tester for information about each. Usage (--help) should also be referenced.
Community, discussion, contribution, and support
Learn how to engage with the Kubernetes community on the community page.
You can reach the maintainers of this project at:
Code of conduct
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
deployer
Package deployer implements the kubetest2 GKE deployer
|
Package deployer implements the kubetest2 GKE deployer |
|
deployer
Package deployer implements the kubetest2 GKE deployer
|
Package deployer implements the kubetest2 GKE deployer |
|
deployer
Package deployer implements the kubetest2 kind deployer
|
Package deployer implements the kubetest2 kind deployer |
|
Package exec implements a kubetest2 tester that simply executes the arguments as a subprocess
|
Package exec implements a kubetest2 tester that simply executes the arguments as a subprocess |
|
pkg
|
|
|
app
Package app implements the kubetest2 high level application logic
|
Package app implements the kubetest2 high level application logic |
|
app/shim
Package shim implements the kubetest2 root command logic, "shimming" to deployer specific binaries
|
Package shim implements the kubetest2 root command logic, "shimming" to deployer specific binaries |
|
build
Package build implements a common system for building kubernetes for deployers to use.
|
Package build implements a common system for building kubernetes for deployers to use. |
|
exec
Package exec contains an interface for executing commands, along with helpers TODO(bentheelder): add standardized timeout functionality & a default timeout so that commands cannot hang indefinitely (!)
|
Package exec contains an interface for executing commands, along with helpers TODO(bentheelder): add standardized timeout functionality & a default timeout so that commands cannot hang indefinitely (!) |
|
process
Package process contains helpers for executing processes in ways that behave similarly to syscall.Exec, but using child processes instead
|
Package process contains helpers for executing processes in ways that behave similarly to syscall.Exec, but using child processes instead |
|
testers/node
Package node implements a node tester that implements e2e node testing following https://github.com/kubernetes/community/blob/master/contributors/devel/sig-node/e2e-node-tests.md#delete-instance-after-tests-run https://github.com/kubernetes/kubernetes/blob/96be00df69390ed41b8ec22facc43bcbb9c88aae/build/root/Makefile#L206-L271 currently only support REMOTE=true
|
Package node implements a node tester that implements e2e node testing following https://github.com/kubernetes/community/blob/master/contributors/devel/sig-node/e2e-node-tests.md#delete-instance-after-tests-run https://github.com/kubernetes/kubernetes/blob/96be00df69390ed41b8ec22facc43bcbb9c88aae/build/root/Makefile#L206-L271 currently only support REMOTE=true |
|
types
Package types defines the common types / interfaces for kubetest2 deployer and tester implementations
|
Package types defines the common types / interfaces for kubetest2 deployer and tester implementations |