summaryrefslogtreecommitdiffhomepage
path: root/test/runtimes/README.md
diff options
context:
space:
mode:
authorgVisor bot <gvisor-bot@google.com>2020-02-11 13:37:40 -0800
committergVisor bot <gvisor-bot@google.com>2020-02-11 13:38:45 -0800
commite07eacc99f00c7318df789f24e7559a7fb941b8e (patch)
tree3c73f0c53ecd6b5d8896ae1d81c51ada37919a4b /test/runtimes/README.md
parentb8e22e241cab625d2809034c74d0ff808b948b4c (diff)
Fix up test/runtimes/README.md.
In particular, explain how to push updates to the images. PiperOrigin-RevId: 294508879
Diffstat (limited to 'test/runtimes/README.md')
-rw-r--r--test/runtimes/README.md31
1 files changed, 23 insertions, 8 deletions
diff --git a/test/runtimes/README.md b/test/runtimes/README.md
index e41e78f77..42d722553 100644
--- a/test/runtimes/README.md
+++ b/test/runtimes/README.md
@@ -12,24 +12,39 @@ The following runtimes are currently supported:
- PHP 7.3
- Python 3.7
-#### Prerequisites:
+### Building and pushing the images:
-1) [Install and configure Docker](https://docs.docker.com/install/)
-
-2) Build each Docker container from the runtimes/images directory:
+The canonical source of images is the
+[gvisor-presubmit container registry](https://gcr.io/gvisor-presubmit/). You can
+build new images with the following command:
```bash
$ cd images
$ docker build -f Dockerfile_$LANG [-t $NAME] .
```
-### Testing:
+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.)
+
+```bash
+gcloud docker -- push gcr.io/gvisor-presubmit/$LANG
+```
+
+#### Running in Docker locally:
+
+1) [Install and configure Docker](https://docs.docker.com/install/)
+
+2) Pull the image you want to run:
+
+```bash
+$ docker pull gcr.io/gvisor-presubmit/$LANG
+```
-If the prerequisites have been fulfilled, you can run the tests with the
-following command:
+3) Run docker with the image.
```bash
-$ docker run --rm -it $NAME [FLAG]
+$ docker run [--runtime=runsc] --rm -it $NAME [FLAG]
```
Running the command with no flags will cause all the available tests to execute.