devel/sig-release: Update getting-builds.md

Signed-off-by: Stephen Augustus <saugustus@vmware.com>

1 files changed, 149 insertions, 17 deletions

diff --git a/contributors/devel/sig-release/getting-builds.md b/contributors/devel/sig-release/getting-builds.md
index da20db57..cd1373bf 100644
--- a/contributors/devel/sig-release/getting-builds.md
+++ b/contributors/devel/sig-release/getting-builds.md
@@ -1,47 +1,179 @@
 # Getting Kubernetes Builds
 
+- [Using `hack/get-build.sh`](#using-hackget-buildsh)
+- [Using `gsutil`](#using-gsutil)
+  - [Install `gsutil`](#install-gsutil)
+  - [Examples](#examples)
+    - [Output the latest CI version number](#output-the-latest-ci-version-number)
+    - [List the contents of a CI release](#list-the-contents-of-a-ci-release)
+    - [List all official releases and RCs](#list-all-official-releases-and-rcs)
+
+## Using `hack/get-build.sh`
+
 You can use [hack/get-build.sh](https://git.k8s.io/kubernetes/hack/get-build.sh)
 to get a build or to use as a reference on how to get the most recent builds
-with curl. With `get-build.sh` you can grab the most recent stable build, the
-most recent release candidate, or the most recent build to pass our ci and gce
+with curl.
+
+With `get-build.sh` you can grab the most recent stable build, the
+most recent release candidate, or the most recent build to pass our CI and GCE
 e2e tests (essentially a nightly build).
 
 Run `./hack/get-build.sh -h` for its usage.
 
-To get a build at a specific version (v1.1.1) use:
+To get a build at a specific version (v1.18.3) use:
 
-```console
-./hack/get-build.sh v1.1.1
+```shell
+./hack/get-build.sh v1.18.3
 ```
 
 To get the latest stable release:
 
-```console
+```shell
 ./hack/get-build.sh release/stable
 ```
 
 Use the "-v" option to print the version number of a build without retrieving
-it. For example, the following prints the version number for the latest ci
+it.
+
+For example, the following prints the version number for the latest ci
 build:
 
-```console
+```shell
 ./hack/get-build.sh -v ci/latest
 ```
 
+## Using `gsutil`
+
 You can also use the gsutil tool to explore the Google Cloud Storage release
-buckets. Here are some examples:
+buckets.
+
+### Install `gsutil`
+
+`gsutil` is part of the Google Cloud SDK.
+Install instructions for the Google Cloud SDK can be found [here](https://cloud.google.com/sdk/install).
 
-```sh
-gsutil cat gs://kubernetes-release-dev/ci/latest.txt           # output the latest ci version number
-gsutil ls gs://kubernetes-release-dev/ci/v0.20.0-29-g29a55cc/  # list the contents of a ci release
-gsutil ls gs://kubernetes-release/release                      # list all official releases and rcs
+### Examples
+
+#### Output the latest CI version number
+
+```console
+$ gsutil cat gs://kubernetes-release-dev/ci/latest.txt
+v1.19.0-beta.2.32+35fc65dc2c614e
 ```
 
-## Install `gsutil`
+#### List the contents of a CI release
 
-Example installation:
+```console
+$ gsutil ls gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA256SUMS
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA256SUMS.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA256SUMS.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA512SUMS
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA512SUMS.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/SHA512SUMS.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-client-linux-amd64.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-client-linux-amd64.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-client-linux-amd64.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-manifests.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-manifests.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-manifests.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-node-linux-amd64.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-node-linux-amd64.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-node-linux-amd64.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-server-linux-amd64.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-server-linux-amd64.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-server-linux-amd64.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-src.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-src.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-src.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-linux-amd64.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-linux-amd64.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-linux-amd64.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-portable.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-portable.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes-test-portable.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes.tar.gz
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes.tar.gz.sha256
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/kubernetes.tar.gz.sha512
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/bin/
+gs://kubernetes-release-dev/ci/v1.19.0-beta.2.32+35fc65dc2c614e/extra/
+```
+
+#### List all official releases and RCs
 
 ```console
-curl -sSL https://storage.googleapis.com/pub/gsutil.tar.gz | sudo tar -xz -C /usr/local/src
-sudo ln -s /usr/local/src/gsutil/gsutil /usr/bin/gsutil
+$ gsutil ls gs://kubernetes-release/release
+gs://kubernetes-release/release/kube-register
+gs://kubernetes-release/release/latest-1.0.txt
+gs://kubernetes-release/release/latest-1.1.txt
+gs://kubernetes-release/release/latest-1.10.txt
+gs://kubernetes-release/release/latest-1.11.txt
+gs://kubernetes-release/release/latest-1.12.txt
+gs://kubernetes-release/release/latest-1.13.txt
+gs://kubernetes-release/release/latest-1.14.txt
+gs://kubernetes-release/release/latest-1.15.txt
+gs://kubernetes-release/release/latest-1.16.txt
+gs://kubernetes-release/release/latest-1.17.txt
+gs://kubernetes-release/release/latest-1.18.txt
+gs://kubernetes-release/release/latest-1.19.txt
+gs://kubernetes-release/release/latest-1.2.txt
+gs://kubernetes-release/release/latest-1.3.txt
+gs://kubernetes-release/release/latest-1.4.txt
+gs://kubernetes-release/release/latest-1.5.txt
+gs://kubernetes-release/release/latest-1.6.txt
+gs://kubernetes-release/release/latest-1.7.txt
+gs://kubernetes-release/release/latest-1.8.txt
+gs://kubernetes-release/release/latest-1.9.txt
+gs://kubernetes-release/release/latest-1.txt
+gs://kubernetes-release/release/latest.txt
+gs://kubernetes-release/release/stable-1.0.txt
+gs://kubernetes-release/release/stable-1.1.txt
+gs://kubernetes-release/release/stable-1.10.txt
+gs://kubernetes-release/release/stable-1.11.txt
+gs://kubernetes-release/release/stable-1.12.txt
+gs://kubernetes-release/release/stable-1.13.txt
+gs://kubernetes-release/release/stable-1.14.txt
+gs://kubernetes-release/release/stable-1.15.txt
+gs://kubernetes-release/release/stable-1.16.txt
+gs://kubernetes-release/release/stable-1.17.txt
+gs://kubernetes-release/release/stable-1.18.txt
+gs://kubernetes-release/release/stable-1.2.txt
+gs://kubernetes-release/release/stable-1.3.txt
+gs://kubernetes-release/release/stable-1.4.txt
+gs://kubernetes-release/release/stable-1.5.txt
+gs://kubernetes-release/release/stable-1.6.txt
+gs://kubernetes-release/release/stable-1.7.txt
+gs://kubernetes-release/release/stable-1.8.txt
+gs://kubernetes-release/release/stable-1.9.txt
+gs://kubernetes-release/release/stable-1.txt
+gs://kubernetes-release/release/stable.txt
+
+<snip>
+
+gs://kubernetes-release/release/v1.18.0-alpha.0/
+gs://kubernetes-release/release/v1.18.0-alpha.1/
+gs://kubernetes-release/release/v1.18.0-alpha.2/
+gs://kubernetes-release/release/v1.18.0-alpha.3/
+gs://kubernetes-release/release/v1.18.0-alpha.5/
+gs://kubernetes-release/release/v1.18.0-beta.0/
+gs://kubernetes-release/release/v1.18.0-beta.1/
+gs://kubernetes-release/release/v1.18.0-beta.2/
+gs://kubernetes-release/release/v1.18.0-rc.1/
+gs://kubernetes-release/release/v1.18.0/
+gs://kubernetes-release/release/v1.18.1-beta.0/
+gs://kubernetes-release/release/v1.18.1/
+gs://kubernetes-release/release/v1.18.2-beta.0/
+gs://kubernetes-release/release/v1.18.2/
+gs://kubernetes-release/release/v1.18.3-beta.0/
+gs://kubernetes-release/release/v1.18.3/
+gs://kubernetes-release/release/v1.18.4-rc.0/
+gs://kubernetes-release/release/v1.19.0-alpha.0/
+gs://kubernetes-release/release/v1.19.0-alpha.1/
+gs://kubernetes-release/release/v1.19.0-alpha.2/
+gs://kubernetes-release/release/v1.19.0-alpha.3/
+gs://kubernetes-release/release/v1.19.0-beta.0/
+gs://kubernetes-release/release/v1.19.0-beta.1/
+gs://kubernetes-release/release/v1.19.0-beta.2/
+
+<snip>
 ```