README
¶
End-to-end tests
The executable built here (e2e-test) is intended to be run manually by a
developer using a cluster and GCP credentials as well as in a container from
within a cluster that has the right service account credentials.
Tests should be written using the standard Golang unit test framework.
basic_test.go is an example of a simple test that creates an Ingress,
validates the configuration, deletes the Ingress and waits for the associated
cloud resources to be removed.
Tests have access to the global variable Framework that contains a k8s
clientset, GCP Cloud client to interact with the environment under test. Per
namespace sandboxes should be created with Framework.RunWithSandbox(). This
is similar in behavior to t.Run() but includes creation of the sandbox:
Framework.RunWithSandbox("my test", t, func(t*testing.T, s *e2e.Sandbox) {
t.Parallel()
// Do your test here.
})
As GCLB provisioning may take some time, it is important to perform your tests
in parallel as much as possible. The easiest way to do this is to put a
t.Parallel() invocation at the start of the func TestFoo(t *testing.T) and
immediately within each call to RunWithSandbox().
Running the tests
Building the tests
For Linux users, the e2e-test binary will be built in a container using the
build make target:
make build
For Mac Users, or to build the tests locally:
go test -c -o bin/amd64/e2e-test k8s.io/ingress-gce/cmd/e2e-test
From the command line
Run tests against your cluster and GCP environment. This uses your default
cluster credentials. -v and -logtostderr will enable verbose logging:
$ bin/amd64/e2e-test -run -project my-project -v 2 -logtostderr
Version: "v1.1.0-183-gfaefb0f2", Commit: "faefb0f257a6c591d19a4768e3a8bc776ad14d33"
I0618 23:51:03.023843 62186 main_test.go:101] Using random seed = 1529391063023834550
I0618 23:51:03.024330 62186 framework.go:104] Catching SIGINT
I0618 23:51:03.024411 62186 framework.go:79] Checking connectivity with Kubernetes API
I0618 23:51:03.464677 62186 framework.go:84] Checking connectivity with Google Cloud API (get project "my-project")
I0618 23:51:04.068408 62186 framework.go:89] Checking external Internet connectivity
...
To run a specific test case, you can use something similar to the command below:
# Ref https://golang.org/cmd/go/#hdr-Testing_flags.
$ bin/amd64/e2e-test -run -project my-project -v 2 -logtostderr -test.run=TestIAP
Note that killing the test with CTRL-C will cause the existing namespace
sandboxes to be deleted, hopefully reducing the amount of cleanup necessary on
an aborted test run:
^C
W0618 23:51:04.157786 62186 framework.go:120] SIGINT received, cleaning up sandboxes (disable with -handleSIGINT=false)
E0618 23:51:04.157869 62186 framework.go:129] Exiting due to SIGINT
Within a cluster
The YAML resource definition cmd/e2e-test/e2e-test.yaml will create RBAC
bindings and a pod built with the end-to-end test binary. Build and push the
image to your own registry:
$ REGISTRY=gcr.io/my-reg make push
$ sed 's/k8s-ingress-image-push/my-reg/g' cmd/e2e-test/e2e-test.yaml > my-e2e-test.yaml
$ kubectl apply -f my-e2e-test.yaml
# Check the test results:
$ kubectl log -n default ingress-e2e
Directories