Merge pull request #5268 from justaugustus/markers

sig-release: Add doc on version markers (migrated from k/test-infra)

Author: k8s-ci-robot

contributors/devel/sig-release/getting-builds.md

@@ -1,12 +1,17 @@
 # Getting Kubernetes Builds
 
+- [Version markers](#version-markers)
 - [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)
+
+## Version markers
+
+Version markers are text files which act as sort of a public API for accessing
+Kubernetes builds.
+
+They are artifacts of a successful Kubernetes build which are stored in a
+Google Cloud Storage bucket alongside the builds they make reference to.
+
+You can read more about version markers [here](./kubernetes-versions.md).
 
 ## Using `hack/get-build.sh`
 
@@ -41,139 +46,3 @@ build:
 ```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.
-
-### 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).
-
-### Examples
-
-#### Output the latest CI version number
-
-```console
-$ gsutil cat gs://kubernetes-release-dev/ci/latest.txt
-v1.19.0-beta.2.32+35fc65dc2c614e
-```
-
-#### List the contents of a CI release
-
-```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
-$ 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>
-```