From 3016b81ef8d0fbca1068791949371d17b14e42d9 Mon Sep 17 00:00:00 2001 From: Jun Xiang Tee Date: Fri, 14 Jul 2017 13:39:56 -0700 Subject: Add more information for e2e.test --- contributors/devel/e2e-tests.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/contributors/devel/e2e-tests.md b/contributors/devel/e2e-tests.md index eefe583b..15d46a50 100644 --- a/contributors/devel/e2e-tests.md +++ b/contributors/devel/e2e-tests.md @@ -145,7 +145,13 @@ go run hack/e2e.go -- -v --down This will not do anything besides allow you to verify that the go code compiles. * If you want to run your e2e testing framework without re-provisioning the e2e setup, - you can do so via `make WHAT=test/e2e/e2e.test` and then re-running the ginkgo tests. + you can do so via `make WHAT=test/e2e/e2e.test` + +* You can then create a symlink pointing `e2e.test` to `_output/local/bin/linux/amd64/e2e.test`, + and re-run the ginkgo tests by providing relevant flags. For example: +```sh +e2e.test --host="127.0.0.1:8080" --provider="local" --repo-root="path/to/main/repo" --kubeconfig="path/to/.kube/config" --ginkgo.focus="regex" +``` ## Advanced testing -- cgit v1.2.3 From 01f96cdbb3984a1a879c4386c8db7eb1a5368a59 Mon Sep 17 00:00:00 2001 From: Jun Xiang Tee Date: Tue, 18 Jul 2017 11:01:29 -0700 Subject: Remove redundant section `Building the Tests` section are redundant - integrated the examples into `Building Kubernetes and Running the Tests` section. --- contributors/devel/e2e-tests.md | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/contributors/devel/e2e-tests.md b/contributors/devel/e2e-tests.md index 15d46a50..b5aadf97 100644 --- a/contributors/devel/e2e-tests.md +++ b/contributors/devel/e2e-tests.md @@ -79,6 +79,11 @@ getting started steps for your chosen cloud platform (which might involve changing the `KUBERNETES_PROVIDER` environment variable to something other than "gce"). +You can quickly recompile the e2e testing framework via `go install ./test/e2e`. +This will not do anything besides allow you to verify that the go code compiles. +If you want to run your e2e testing framework without re-provisioning the e2e setup, +you can do so via `make WHAT=test/e2e/e2e.test`. + To build Kubernetes, up a cluster, run tests, and tear everything down, use: ```sh @@ -98,7 +103,11 @@ go run hack/e2e.go -- -v --up go run hack/e2e.go -- -v --test # Run tests matching the regex "\[Feature:Performance\]" -go run hack/e2e.go -- -v --test --test_args="--ginkgo.focus=\[Feature:Performance\]" +# Specify "--provider=local" flag when running the tests locally +go run hack/e2e.go -- -v --test --test_args="--ginkgo.focus=\[Feature:Performance\]" --provider=local + +# Alternatively, specify it with KUBERNETES_PROVIDER +KUBERNETES_PROVIDER=local go run hack/e2e.go -- -v --build --up --test --down # Conversely, exclude tests that match the regex "Pods.*env" go run hack/e2e.go -- -v --test --test_args="--ginkgo.skip=Pods.*env" @@ -139,20 +148,6 @@ with this command: go run hack/e2e.go -- -v --down ``` -## Building the Tests - -* You can quickly recompile the e2e testing framework via `go install ./test/e2e`. - This will not do anything besides allow you to verify that the go code compiles. - -* If you want to run your e2e testing framework without re-provisioning the e2e setup, - you can do so via `make WHAT=test/e2e/e2e.test` - -* You can then create a symlink pointing `e2e.test` to `_output/local/bin/linux/amd64/e2e.test`, - and re-run the ginkgo tests by providing relevant flags. For example: -```sh -e2e.test --host="127.0.0.1:8080" --provider="local" --repo-root="path/to/main/repo" --kubeconfig="path/to/.kube/config" --ginkgo.focus="regex" -``` - ## Advanced testing ### Installing/updating kubetest -- cgit v1.2.3 From 07c6da22fe9f97ab44a02e67a7c574b49998605d Mon Sep 17 00:00:00 2001 From: Jun Xiang Tee Date: Fri, 4 Aug 2017 12:23:20 -0700 Subject: Remove deprecated KUBERNETES_PROVIDER=local --- contributors/devel/e2e-tests.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/contributors/devel/e2e-tests.md b/contributors/devel/e2e-tests.md index b5aadf97..639fe2f2 100644 --- a/contributors/devel/e2e-tests.md +++ b/contributors/devel/e2e-tests.md @@ -106,9 +106,6 @@ go run hack/e2e.go -- -v --test # Specify "--provider=local" flag when running the tests locally go run hack/e2e.go -- -v --test --test_args="--ginkgo.focus=\[Feature:Performance\]" --provider=local -# Alternatively, specify it with KUBERNETES_PROVIDER -KUBERNETES_PROVIDER=local go run hack/e2e.go -- -v --build --up --test --down - # Conversely, exclude tests that match the regex "Pods.*env" go run hack/e2e.go -- -v --test --test_args="--ginkgo.skip=Pods.*env" -- cgit v1.2.3 From 94e51042328a1e527a50e1756a4e8cbbf6361644 Mon Sep 17 00:00:00 2001 From: Jun Xiang Tee Date: Thu, 17 Aug 2017 16:52:33 -0700 Subject: Address feedback --- contributors/devel/e2e-tests.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contributors/devel/e2e-tests.md b/contributors/devel/e2e-tests.md index 639fe2f2..6dccf8cb 100644 --- a/contributors/devel/e2e-tests.md +++ b/contributors/devel/e2e-tests.md @@ -82,7 +82,7 @@ changing the `KUBERNETES_PROVIDER` environment variable to something other than You can quickly recompile the e2e testing framework via `go install ./test/e2e`. This will not do anything besides allow you to verify that the go code compiles. If you want to run your e2e testing framework without re-provisioning the e2e setup, -you can do so via `make WHAT=test/e2e/e2e.test`. +you can do so via `make WHAT=test/e2e/e2e.test`, and then re-running the ginkgo tests. To build Kubernetes, up a cluster, run tests, and tear everything down, use: @@ -102,7 +102,7 @@ go run hack/e2e.go -- -v --up # Run all tests go run hack/e2e.go -- -v --test -# Run tests matching the regex "\[Feature:Performance\]" +# Run tests matching the regex "\[Feature:Performance\]" against a local cluster # Specify "--provider=local" flag when running the tests locally go run hack/e2e.go -- -v --test --test_args="--ginkgo.focus=\[Feature:Performance\]" --provider=local -- cgit v1.2.3