Skip to content

Commit 0dc3cef

Browse files
Merge pull request #12807 from sharifelgamal/conformance-docs
update conformance test instructions in documentation
2 parents 6bbf98d + eed2bf6 commit 0dc3cef

File tree

1 file changed

+13
-18
lines changed

1 file changed

+13
-18
lines changed

site/content/en/docs/contrib/testing.en.md

Lines changed: 13 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -81,26 +81,21 @@ Tests are typically read with a great air of skepticism, because chances are the
8181
These are Kubernetes tests that run against an arbitrary cluster and exercise a wide range of Kubernetes features.
8282
You can run these against minikube by following these steps:
8383

84-
* Clone the Kubernetes repo somewhere on your system.
85-
* Run `make quick-release` in the k8s repo.
86-
* Start up a minikube cluster with: `minikube start`.
87-
* Set following two environment variables:
88-
89-
```shell
90-
export KUBECONFIG=$HOME/.kube/config
91-
export KUBERNETES_CONFORMANCE_TEST=y
84+
Install [docker](https://docs.docker.com/engine/install/)
85+
Install [kubectl](https://v1-18.docs.kubernetes.io/docs/tasks/tools/install-kubectl/)
86+
Clone the [minikube repo](https://github.com/kubernetes/minikube)
87+
88+
## Compile the latest minikube binary
89+
```console
90+
% cd <minikube dir>
91+
% make
9292
```
9393

94-
* Run the tests (from the k8s repo):
94+
## Trigger the tests and get back the results
9595

96-
```shell
97-
go run hack/e2e.go -v --test --test_args="--ginkgo.focus=\[Conformance\]" --check-version-skew=false
96+
```console
97+
% cd <minikube dir>
98+
./hack/conformance_tests.sh out/minikube --driver=docker --container-runtimer=docker --kubernetes-version=stable
9899
```
99100

100-
To run a specific conformance test, you can use the `ginkgo.focus` flag to filter the set using a regular expression.
101-
The `hack/e2e.go` wrapper and the `e2e.sh` wrappers have a little trouble with quoting spaces though, so use the `\s` regular expression character instead.
102-
For example, to run the test `should update annotations on modification [Conformance]`, use following command:
103-
104-
```shell
105-
go run hack/e2e.go -v --test --test_args="--ginkgo.focus=should\supdate\sannotations\son\smodification" --check-version-skew=false
106-
```
101+
This script will run the latest sonobuoy against a minikube cluster with two nodes and the provided parameters.

0 commit comments

Comments
 (0)