docs: Add instructions on how to download isolated intermediaries.

Screenshot:
  https://screenshot.googleplex.com/2cXAQMqypHv.png

BUG=skia:
GOLD_TRYBOT_URL= https://gold.skia.org/search?issue=2316113002
NOTRY=true
DOCS_PREVIEW= https://skia.org/?cl=2316113002

Review-Url: https://codereview.chromium.org/2316113002

diff --git a/site/dev/testing/Isolate.png b/site/dev/testing/Isolate.png
new file mode 100644 (file)
index 0000000..b6330b9
Binary files /dev/null and b/site/dev/testing/Isolate.png differ

diff --git a/site/dev/testing/Status.png b/site/dev/testing/Status.png
new file mode 100644 (file)
index 0000000..4b835eb
Binary files /dev/null and b/site/dev/testing/Status.png differ

diff --git a/site/dev/testing/download.md b/site/dev/testing/download.md
new file mode 100644 (file)
index 0000000..ef56f9f
--- /dev/null
+++ b/site/dev/testing/download.md
@@ -0,0 +1,32 @@
+Downloading Isolates
+====================
+
+The intermediate and final build products from running tests are all stored in
+[Isolate](https://github.com/luci/luci-py/blob/master/appengine/isolate/doc/Design.md),
+and can be downloaded to the desktop for inspection and debugging.
+
+First install the client:
+
+     git clone https://github.com/luci/client-py.git
+
+Add the checkout location to your $PATH.
+
+To download the isolated files for a test first visit
+the build status page and find the "isolated output" link:
+
+<img src="Status.png" style="margin-left:30px" width=576 height=271 >
+
+
+Follow that link to find the hash of the isolated outputs:
+
+
+<img src="Isolate.png" style="margin-left:30px" width=451 height=301 >
+
+Then run `isolateserver.py` with --isolated set to that hash:
+
+    $ isolateserver.py \
+      download \
+      --isolate-server=https://isolateserver.appspot.com \
+      --isolated=5b85b7c382ee2a34530e33c7db20a07515ff9481 \
+      --target=./download/
+