summaryrefslogtreecommitdiffhomepage
path: root/runsc/test/runtimes/README.md
diff options
context:
space:
mode:
authorSamantha Sample <samsample@google.com>2019-07-26 10:56:43 -0700
committergVisor bot <gvisor-bot@google.com>2019-07-26 10:57:53 -0700
commit444a9d9e545f01dc204f1863e91acb8700823c6e (patch)
treea812152214de367be6eebca02b8dee9c218196e1 /runsc/test/runtimes/README.md
parent7052d21dc45be8ba5ba82117aedc0cb6ecb7c1b7 (diff)
Publish Dockerfiles and test-runner binaries for running language tests.
By following the directions in the README file, these Dockerfiles can be built and used to run native language tests for their respective runtimes. PiperOrigin-RevId: 260174430
Diffstat (limited to 'runsc/test/runtimes/README.md')
-rw-r--r--runsc/test/runtimes/README.md40
1 files changed, 40 insertions, 0 deletions
diff --git a/runsc/test/runtimes/README.md b/runsc/test/runtimes/README.md
new file mode 100644
index 000000000..4e5a950bc
--- /dev/null
+++ b/runsc/test/runtimes/README.md
@@ -0,0 +1,40 @@
+# 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
+
+#### Prerequisites:
+
+1) [Install and configure Docker](https://docs.docker.com/install/)
+
+2) Build each Docker container:
+
+```bash
+$ docker build -f $LANG/Dockerfile [-t $NAME] .
+```
+
+### Testing:
+
+If the prerequisites have been fulfilled, you can run the tests with the
+following command:
+
+```bash
+$ docker run --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 &lt;name&gt;: Run a single test from the list of available tests
+- --v: Print the language version