README
¶
Integration Testing
The integration tests are end-to-end and designed to test real user scenarios against a live Kubernetes cluster.
Build and run integration tests
Requirements
The following is required to build and run the integration tests:
- Golang 1.9 or higher
- Kubernetes v1.9.x or higher (e.g. OKE/OCE, terraform-kubernetes-installer, Docker for Mac with Kubernetes)
Run integration tests
There are a variety of ways to run and configure the integration tests including from the top-level Makefile and using go test.
Configure integration tests
The following parameters can be used to configure the tests:
| Test parameter | Description | Makefile variable | Default value |
|---|---|---|---|
| kubeconfig | path to kubeconfig | KUBECONFIG | "" |
| externalIp | external IP over which to access deployments | INTEG_K8S_EXTERNAL_IP | localhost |
| namespace | integration test namespace to use | K8S_NAMESPACE | default |
| skipteardown | skips tearing down VMO instances and artifacts created by the tests (useful to save test run) | INTEG_SKIP_TEARDOWN | false |
| runid | optional string that will be used to uniquely identify this test run | INTEG_RUN_ID | generated |
| phase | optional phase to test (before | after) | none |
Run all integration from the top-level Makefile
make integ-test KUBECONFIG=${KUBECONFIG} K8S_EXTERNAL_IP=${INTEG_K8S_EXTERNAL_IP}
Run all integration tests using go test
go test -v ./test/integ/ --kubeconfig=$KUBECONFIG --externalip=$INTEG_K8S_EXTERNAL_IP --namespace=default
Run a specific integration tests using go test
go test -v ./test/integ/ -run SimpleVMO --kubeconfig=$KUBECONFIG --externalip=$INTEG_K8S_EXTERNAL_IP --namespace=integ-test
Developing new tests
Re-compile the test framework and utils
go install ./test/integ/framework/ ./test/integ/client/ ./test/integ/util/
Directories
Click to show internal directories.
Click to hide internal directories.