gvisor/test/runtimes/README.md

1.4 KiB

Runtimes Tests Dockerfiles

The Dockerfiles defined under this path are configured to host the execution of the runtimes language tests. Each Dockerfile can support the language indicated by its directory.

The following runtimes are currently supported:

  • Go 1.12
  • Java 11
  • Node.js 12
  • PHP 7.3
  • Python 3.7

Building and pushing the images:

The canonical source of images is the gvisor-presubmit container registry. You can build new images with the following command:

$ cd images
$ docker build -f Dockerfile_$LANG [-t $NAME] .

To push them to our container registry, set the tag in the command above to gcr.io/gvisor-presubmit/$LANG, then push them. (Note that you will need appropriate permissions to the gvisor-presubmit GCP project.)

gcloud docker -- push gcr.io/gvisor-presubmit/$LANG

Running in Docker locally:

  1. Install and configure Docker

  2. Pull the image you want to run:

$ docker pull gcr.io/gvisor-presubmit/$LANG
  1. Run docker with the image.
$ docker run [--runtime=runsc] --rm -it $NAME [FLAG]

Running the command with no flags will cause all the available tests to execute.

Flags can be added for additional functionality:

  • --list: Print a list of all available tests
  • --test <name>: Run a single test from the list of available tests
  • --v: Print the language version