test: Update and organize README
Document the alternate runtime selection when running integratiom tests on the host, and at the same time rganize the file a little better. Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
This commit is contained in:
parent
5f0238032f
commit
5569f8b2e1
1 changed files with 32 additions and 9 deletions
|
@ -13,25 +13,21 @@ Integration tests are written in *bash* using the
|
||||||
|
|
||||||
## Running integration tests
|
## Running integration tests
|
||||||
|
|
||||||
|
### Containerized tests
|
||||||
|
|
||||||
The easiest way to run integration tests is with Docker:
|
The easiest way to run integration tests is with Docker:
|
||||||
```
|
```
|
||||||
$ make integration
|
$ make integration
|
||||||
```
|
```
|
||||||
Alternatively, you can run integration tests directly on your host through make:
|
|
||||||
```
|
|
||||||
$ sudo make localintegration
|
|
||||||
```
|
|
||||||
Or you can just run them directly using bats
|
|
||||||
```
|
|
||||||
$ sudo bats test
|
|
||||||
```
|
|
||||||
To run a single test bucket:
|
To run a single test bucket:
|
||||||
```
|
```
|
||||||
$ make integration TESTFLAGS="runtimeversion.bats"
|
$ make integration TESTFLAGS="runtimeversion.bats"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### On your host
|
||||||
|
|
||||||
To run them on your host, you will need to setup a development environment plus
|
To run the integration tests on your host, you will first need to setup a development environment plus
|
||||||
[bats](https://github.com/sstephenson/bats#installing-bats-from-source)
|
[bats](https://github.com/sstephenson/bats#installing-bats-from-source)
|
||||||
For example:
|
For example:
|
||||||
```
|
```
|
||||||
|
@ -41,6 +37,33 @@ $ cd bats
|
||||||
$ ./install.sh /usr/local
|
$ ./install.sh /usr/local
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Then you can run the tests on your host:
|
||||||
|
```
|
||||||
|
$ sudo make localintegration
|
||||||
|
```
|
||||||
|
|
||||||
|
To run a single test bucket:
|
||||||
|
```
|
||||||
|
$ make localintegration TESTFLAGS="runtimeversion.bats"
|
||||||
|
```
|
||||||
|
|
||||||
|
Or you can just run them directly using bats
|
||||||
|
```
|
||||||
|
$ sudo bats test
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Runtime selection
|
||||||
|
Tests on the host will run with `runc` as the default runtime.
|
||||||
|
However you can select other OCI compatible runtimes by setting
|
||||||
|
the `RUNTIME` environment variable.
|
||||||
|
|
||||||
|
For example one could use the [Clear Containers](https://github.com/01org/cc-oci-runtime/wiki/Installation)
|
||||||
|
runtime instead of `runc`:
|
||||||
|
|
||||||
|
```
|
||||||
|
make localintegration RUNTIME=cc-oci-runtime
|
||||||
|
```
|
||||||
|
|
||||||
## Writing integration tests
|
## Writing integration tests
|
||||||
|
|
||||||
[Helper functions]
|
[Helper functions]
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue