aboutsummaryrefslogtreecommitdiffstats
path: root/tools/docker
diff options
context:
space:
mode:
authorDmitry Vyukov <dvyukov@google.com>2020-09-12 14:45:10 +0200
committerDmitry Vyukov <dvyukov@google.com>2020-09-12 16:26:58 +0200
commit9296c80bbce49adf175bb56d59ebf614b54ca190 (patch)
treeaf0bafef561f43ba34768de137e3b919a004c76d /tools/docker
parentce441f065b6eebb166bb006dfd28ea0c6b730384 (diff)
tools/docker: mirror images on github
Some users don't have access to the gcr.io registry. Mirror images on github as well.
Diffstat (limited to 'tools/docker')
-rw-r--r--tools/docker/README.md30
-rw-r--r--tools/docker/big-env/Dockerfile8
-rw-r--r--tools/docker/env/Dockerfile14
-rw-r--r--tools/docker/old-env/Dockerfile14
4 files changed, 33 insertions, 33 deletions
diff --git a/tools/docker/README.md b/tools/docker/README.md
new file mode 100644
index 000000000..313cf59ce
--- /dev/null
+++ b/tools/docker/README.md
@@ -0,0 +1,30 @@
+# Docker images
+
+We provide a set of Docker images that provide dev environment suitable for syzkaller development/testing.
+These images are used by CI, but can also be used for [local development](/docs/contributing.md#using-syz-env).
+
+- [env](/tools/docker/env/Dockerfile) includes Go toolchain, C/C++ cross-compilers, make, git and other essential tools.
+- [big-env](/tools/docker/big-env/Dockerfile) includes akaros/fuchsia/netbsd toolchains and gcloud sdk on top of `env` image.
+- [old-env](/tools/docker/old-env/Dockerfile) provides essential tools but based on an older disto (ubuntu:16.04).
+
+These images are available as `gcr.io/syzkaller/{env,big-env,old-env}`, respectively.
+
+To download and run locally:
+```
+docker pull gcr.io/syzkaller/env
+docker run -it gcr.io/syzkaller/env
+```
+
+To build and push a new version:
+```
+docker build -t gcr.io/syzkaller/env tools/docker/env
+gcloud auth login && gcloud auth configure-docker
+docker push gcr.io/syzkaller/env
+```
+
+Also upload a copy to Github packages (some users don't have access to `gcr.io`):
+```
+docker tag gcr.io/syzkaller/env docker.pkg.github.com/google/syzkaller/env
+docker login https://docker.pkg.github.com
+docker push docker.pkg.github.com/google/syzkaller/env
+```
diff --git a/tools/docker/big-env/Dockerfile b/tools/docker/big-env/Dockerfile
index cf3d7670a..ec225ed7c 100644
--- a/tools/docker/big-env/Dockerfile
+++ b/tools/docker/big-env/Dockerfile
@@ -1,13 +1,7 @@
# Copyright 2020 syzkaller project authors. All rights reserved.
# Use of this source code is governed by Apache 2 LICENSE that can be found in the LICENSE file.
-# The image provides dev environment suitable for syzkaller development/testing.
-# On top of syz-env it provides akaros/fuchsia/netbsd toolchains and gcloud sdk.
-
-# The image is available as gcr.io/syzkaller/big-env.
-
-# Build as:
-# docker build -t gcr.io/syzkaller/big-env tools/docker/big-env
+# See /tools/docker/README.md for details.
FROM gcr.io/syzkaller/env
diff --git a/tools/docker/env/Dockerfile b/tools/docker/env/Dockerfile
index a10fdec0d..abad26420 100644
--- a/tools/docker/env/Dockerfile
+++ b/tools/docker/env/Dockerfile
@@ -1,19 +1,7 @@
# Copyright 2020 syzkaller project authors. All rights reserved.
# Use of this source code is governed by Apache 2 LICENSE that can be found in the LICENSE file.
-# The image provides dev environment suitable for syzkaller development/testing.
-# It includes Go toolchain and C/C++ cross-compilers.
-
-# The image is available as gcr.io/syzkaller/env.
-
-# To download and run locally:
-# docker pull gcr.io/syzkaller/env
-# docker run -it gcr.io/syzkaller/env
-
-# To build and push new version:
-# docker build -t gcr.io/syzkaller/env tools/docker/env
-# gcloud auth login && gcloud auth configure-docker
-# docker push gcr.io/syzkaller/env
+# See /tools/docker/README.md for details.
FROM debian:buster
diff --git a/tools/docker/old-env/Dockerfile b/tools/docker/old-env/Dockerfile
index 1d87853aa..08c3f215e 100644
--- a/tools/docker/old-env/Dockerfile
+++ b/tools/docker/old-env/Dockerfile
@@ -1,19 +1,7 @@
# Copyright 2020 syzkaller project authors. All rights reserved.
# Use of this source code is governed by Apache 2 LICENSE that can be found in the LICENSE file.
-# The image provides dev environment suitable for syzkaller development/testing.
-# It includes Go toolchain and C/C++ cross-compilers.
-
-# The image is available as gcr.io/syzkaller/old-env.
-
-# To download and run locally:
-# docker pull gcr.io/syzkaller/old-env
-# docker run -it gcr.io/syzkaller/old-env
-
-# To build and push new version:
-# docker build -t gcr.io/syzkaller/old-env tools/docker/old-env
-# gcloud auth login && gcloud auth configure-docker
-# docker push gcr.io/syzkaller/old-env
+# See /tools/docker/README.md for details.
FROM ubuntu:16.04