go
/
gvisor
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
gvisor/test
History
Zach Koopmans 98f9527c04 Port nginx and move parsers to own package. 
This change:
- Ports the nginx benchmark.
- Switches the Httpd benchmark to use 'hey' as a client.
- Moves all parsers to their own package 'tools'.

Parsers are moved to their own package because 1) parsing output of a command
is often dependent on the format of the command (e.g. 'fio --json'), 2) to
enable easier reuse, and 3) clean up and simplify actual running benchmarks
(no TestParser functions and ugly sample output in benchmark files).

PiperOrigin-RevId: 324144165
 		2020-07-30 21:17:45 -07:00
..
benchmarks Port nginx and move parsers to own package. 2020-07-30 21:17:45 -07:00
cmd/test_app Simplify Docker test infrastructure. 2020-04-23 11:33:30 -07:00
e2e Call lseek(0, SEEK_CUR) unconditionally in runsc fsgofer's Readdir(offset=0). 2020-07-30 15:02:22 -07:00
image Add standard entrypoints for test targets. 2020-07-20 18:05:05 -07:00
iptables ip6tables testing 2020-07-28 10:51:14 -07:00
packetdrill Add standard entrypoints for test targets. 2020-07-20 18:05:05 -07:00
packetimpact Test UDP socket bound to ANY can receive unicast 2020-07-29 06:23:23 -07:00
perf Internal change. 2020-06-23 14:42:15 -07:00
root Add standard entrypoints for test targets. 2020-07-20 18:05:05 -07:00
runner Merge pull request #3377 from kevinGC:native-tags 2020-07-27 11:10:24 -07:00
runtimes [runtime tests] go language test enhancement 2020-07-30 10:26:09 -07:00
syscalls Fix SETOWN_EX return value. 2020-07-30 10:27:44 -07:00
uds Standardize on tools directory. 2020-01-27 12:21:00 -08:00
util Merge pull request #3165 from ridwanmsharif:ridwanmsharif/fuse-off-by-default 2020-07-15 12:14:42 -07:00
BUILD Standardize on tools directory. 2020-01-27 12:21:00 -08:00
README.md Fix typos in test/README.md. 2020-06-17 09:13:09 -07:00

README.md

Tests

The tests defined under this path are verifying functionality beyond what unit tests can cover, e.g. integration and end to end tests. Due to their nature, they may need extra setup in the test machine and extra configuration to run.

  • syscalls: system call tests use a local runner, and do not require additional configuration in the machine.
  • integration: defines integration tests that uses docker run to test functionality.
  • image: basic end to end test for popular images. These require the same setup as integration tests.
  • root: tests that require to be run as root. These require the same setup as integration tests.
  • util: utilities library to support the tests.

For the above noted cases, the relevant runtime must be installed via runsc install before running. Just note that they require specific configuration to work. This is handled automatically by the test scripts in the scripts directory and they can be used to run tests locally on your machine. They are also used to run these tests in kokoro.

Example:

To run image and integration tests, run:

./scripts/docker_tests.sh

To run root tests, run:

./scripts/root_tests.sh

There are a few other interesting variations for image and integration tests:

  • overlay: sets writable overlay inside the sentry
  • hostnet: configures host network pass-thru, instead of netstack
  • kvm: runsc the test using the KVM platform, instead of ptrace

The test will build runsc, configure it with your local docker, restart dockerd, and run tests. The location for runsc logs is printed to the output.