Home | History | Annotate | Download | only in testing
      1 Downloading SKPs
      2 ================
      3 
      4 ### Contents ###
      5 
      6 *   [Overview](#overview)
      7 *   [How to download SKPs](#download_skps)
      8     +   [Buildbot SKPs (for Googlers)](#buildbot_skps_googler)
      9     +   [Buildbot SKPs (for trusted partners)](#buildbot_skps_partners)
     10     +   [Cluster Telemetry SKPs (for Googlers)](#ct_skps_googler)
     11 
     12 <a name="overview"></a>
     13 Overview
     14 --------
     15 
     16 An SKP is a binary representation of the draw commands Chromium sends to Skia for rasterization.
     17 
     18 Skia uses different types of SKPs in our continuous builds and tests:
     19 
     20 * [Buildbot](https://skia.org/dev/testing/buildbot) SKPs are the small set (89 as of 2/10/16) of SKPs that are used on almost all our bots.
     21 * [Cluster Telemetry](https://skia.org/dev/testing/ct) SKPs are the much larger set (~900k) that are used by our CT bots (Eg: [CT_BENCH_10k](https://build.chromium.org/p/client.skia/builders/Perf-Ubuntu-GCC-GCE-CPU-AVX2-x86_64-Release-CT_BENCH_10k_SKPs), [CT_DM_10k](https://build.chromium.org/p/client.skia/builders/Test-Ubuntu-GCC-GCE-CPU-AVX2-x86_64-Debug-CT_DM_10k_SKPs), [CT_DM_1m](https://build.chromium.org/p/client.skia.fyi/builders/Test-Ubuntu-GCC-GCE-CPU-AVX2-x86_64-Debug-CT_DM_1m_SKPs)).
     22 
     23 Skia developers find it useful to download these SKPs to run local tests to reproduce problems seen on the buildbots. The below sections detail how to download them.
     24 
     25 <a name="download_skps"></a>
     26 How to download SKPs
     27 --------------------
     28 
     29 <a name="buildbot_skps_googler"></a>
     30 ### Buildbot SKPs (for Googlers)
     31 
     32 The following will work only if you have a google.com account.
     33 
     34 All buildbot SKP files created by the RecreateSKPs bot are available in the Google Storage bucket gs://chromium-skia-gm, they can be copied over to your local directory like this:
     35 
     36 * Download the gsutil tool https://developers.google.com/cloud/sdk/#Quick_Start.
     37 * Authenticate using your google.com credentials gcloud auth login
     38 * Get the current SKP version from https://skia.googlesource.com/skia/+/master/SKP_VERSION.
     39 * Run in your terminal:
     40 
     41     $ SKP\_VERSION=...<br/>
     42     $ SKP\_DEST=...<br/>
     43     $ gsutil -m cp gs://chromium-skia-gm/playback\_${SKP\_VERSION}/skps/*.skp ${SKP\_DEST}
     44 
     45 
     46 <a name="buildbot_skps_partners"></a>
     47 ### Buildbot SKPs (for trusted partners)
     48 
     49 * Request access to the gs://chrome-partner-telemetry bucket by emailing telemetry (a] chromium.org ([example](https://groups.google.com/a/chromium.org/d/msg/telemetry/kSwcgH7KiYs/zwBwEZaadOIJ)).
     50 * Once approved you can download Skia's weekly refreshed buildbot SKPs from gs://chrome-partner-telemetry/skps
     51 
     52 
     53 <a name="ct_skps_googler"></a>
     54 ### Cluster Telemetry SKPs (for Googlers)
     55 
     56 The following will work only if you have a google.com account.
     57 
     58 * Download the gsutil tool https://developers.google.com/cloud/sdk/#Quick_Start.
     59 * Authenticate using your google.com credentials gcloud auth login
     60 * Look at the SKP Repository list [here](https://ct.skia.org/lua_script/) for all available SKPs.
     61 * Run in your terminal:
     62 
     63     $ SKP\_DEST=...<br/>
     64     $ REPO\_TYPE=... (Either All, Mobile10k, 10k, Dummy1k)<br/>
     65     $ CHROMIUM\_BUILD=... (Eg: 57259e0-05dcb4c)<br/>
     66     $ SLAVE\_NUM=... (There are 100 available slaves)<br/>
     67     $ gsutil -m cp gs://cluster-telemetry/skps/${REPO\_TYPE}/${CHROMIUM\_BUILD}/slave${SLAVE\_NUM}/*.skp ${SKP\_DEST}
     68