Move integration testing doc from the readme.md to the website
parent
af98f75029
commit
dc526455f0
|
@ -16,8 +16,9 @@ make test
|
||||||
|
|
||||||
### Integration Tests
|
### Integration Tests
|
||||||
|
|
||||||
Integration tests are currently run manually.
|
#### The basics
|
||||||
To run them, build the binary and run the tests:
|
|
||||||
|
From the minikube root directory, build the binary and run the tests:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
make integration
|
make integration
|
||||||
|
@ -29,6 +30,34 @@ You may find it useful to set various options to test only a particular test aga
|
||||||
env TEST_ARGS="-minikube-start-args=--driver=hyperkit -test.run TestStartStop" make integration
|
env TEST_ARGS="-minikube-start-args=--driver=hyperkit -test.run TestStartStop" make integration
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Quickly iterating on a single test
|
||||||
|
|
||||||
|
Run a single test on an active cluster:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
make integration -e TEST_ARGS="-test.run TestFunctional/parallel/MountCmd --profile=minikube --cleanup=false"
|
||||||
|
```
|
||||||
|
|
||||||
|
WARNING: For this to work repeatedly, the test must be written so that it cleans up after itself.
|
||||||
|
|
||||||
|
The `--cleanup=false` test arg ensures that the cluster will not be deleted after the test is run.
|
||||||
|
|
||||||
|
See [main.go](https://github.com/kubernetes/minikube/blob/master/test/integration/main.go) for details.
|
||||||
|
|
||||||
|
#### Disabling parallelism
|
||||||
|
|
||||||
|
```shell
|
||||||
|
make integration -e TEST_ARGS="-test.parallel=1"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Testing philosophy
|
||||||
|
|
||||||
|
- Tests should be so simple as to be correct by inspection
|
||||||
|
- Readers should need to read only the test body to understand the test
|
||||||
|
- Top-to-bottom readability is more important than code de-duplication
|
||||||
|
|
||||||
|
Tests are typically read with a great air of skepticism, because chances are they are being read only when things are broken.
|
||||||
|
|
||||||
### Conformance Tests
|
### Conformance Tests
|
||||||
|
|
||||||
These are Kubernetes tests that run against an arbitrary cluster and exercise a wide range of Kubernetes features.
|
These are Kubernetes tests that run against an arbitrary cluster and exercise a wide range of Kubernetes features.
|
||||||
|
|
|
@ -1,29 +1 @@
|
||||||
# Integration tests
|
This document has moved to https://minikube.sigs.k8s.io/docs/contrib/testing/#integration-tests
|
||||||
|
|
||||||
## The basics
|
|
||||||
|
|
||||||
To run all tests from the minikube root directory:
|
|
||||||
|
|
||||||
`make integration`
|
|
||||||
|
|
||||||
## Quickly iterating on a single test
|
|
||||||
|
|
||||||
Run a single test on an active cluster:
|
|
||||||
|
|
||||||
`make integration -e TEST_ARGS="-test.run TestFunctional/parallel/MountCmd --profile=minikube --cleanup=false"`
|
|
||||||
|
|
||||||
WARNING: For this to work repeatedly, the test must be written so that it cleans up after itself.
|
|
||||||
|
|
||||||
See `main.go` for details.
|
|
||||||
|
|
||||||
## Disabling parallelism
|
|
||||||
|
|
||||||
`make integration -e TEST_ARGS="-test.parallel=1"`
|
|
||||||
|
|
||||||
## Testing philosophy
|
|
||||||
|
|
||||||
- Tests should be so simple as to be correct by inspection
|
|
||||||
- Readers should need to read only the test body to understand the test
|
|
||||||
- Top-to-bottom readability is more important than code de-duplication
|
|
||||||
|
|
||||||
Tests are typically read with a great air of skepticism, because chances are they are being read only when things are broken.
|
|
||||||
|
|
Loading…
Reference in New Issue