diff options
| author | Erick Fejta <erick@fejta.com> | 2017-02-24 10:43:19 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-02-24 10:43:19 -0800 |
| commit | 96b96bca7655f41c0c1f42ffc7274d469b3570cd (patch) | |
| tree | e5ef9d51fc8b26c22f4e3fd50fb4a178584588b0 | |
| parent | 2f099016973a83eedaae079717880a4e01341f6a (diff) | |
| parent | e5e43742aae0a91184a5b76d5527d04d3cf831e1 (diff) | |
Merge pull request #399 from fejta/e2e
Add --extract=E documentation
| -rw-r--r-- | contributors/devel/e2e-tests.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/contributors/devel/e2e-tests.md b/contributors/devel/e2e-tests.md index c6afdbf5..8a6d8035 100644 --- a/contributors/devel/e2e-tests.md +++ b/contributors/devel/e2e-tests.md @@ -10,6 +10,8 @@ Updated: 5/3/2016 - [Building and Running the Tests](#building-and-running-the-tests) - [Cleaning up](#cleaning-up) - [Advanced testing](#advanced-testing) + - [Installing/updating kubetest](#installingupdating-kubetest) + - [Extracting a specific version of kubernetes](#extracting-a-specific-version-of-kubernetes) - [Bringing up a cluster for testing](#bringing-up-a-cluster-for-testing) - [Federation e2e tests](#federation-e2e-tests) - [Configuring federation e2e tests](#configuring-federation-e2e-tests) @@ -153,6 +155,39 @@ go run hack/e2e.go --get=false -- # Never attempt to install/update. go install k8s.io/test-infra/kubetest # Manually install go get -u k8s.io/test-infra/kubetest # Manually update installation ``` +### Extracting a specific version of kubernetes + +The `kubetest` binary can download and extract a specific version of kubernetes, +both the server, client and test binaries. The `--extract=E` flag enables this +functionality. + +There are a variety of values to pass this flag: + +```sh +# Official builds: <ci|release>/<latest|stable>[-N.N] +go run hack/e2e.go -- --extract=ci/latest --up # Deploy the latest ci build. +go run hack/e2e.go -- --extract=ci/latest-1.5 --up # Deploy the latest 1.5 CI build. +go run hack/e2e.go -- --extract=release/latest --up # Deploy the latest RC. +go run hack/e2e.go -- --extract=release/stable-1.5 --up # Deploy the 1.5 release. + +# A specific version: +go run hack/e2e.go -- --extract=v1.5.1 --up # Deploy 1.5.1 +go run hack/e2e.go -- --extract=v1.5.2-beta.0 --up # Deploy 1.5.2-beta.0 +go run hack/e2e.go -- --extract=gs://foo/bar --up # --stage=gs://foo/bar + +# Whatever GKE is using (gke, gke-staging, gke-test): +go run hack/e2e.go -- --extract=gke --up # Deploy whatever GKE prod uses + +# Using a GCI version: +go run hack/e2e.go -- --extract=gci/gci-canary --up # Deploy the version for next gci release +go run hack/e2e.go -- --extract=gci/gci-57 # Deploy the version bound to gci m57 +go run hack/e2e.go -- --extract=gci/gci-57/ci/latest # Deploy the latest CI build using gci m57 for the VM image + +# Reuse whatever is already built +go run hack/e2e.go -- --up # Most common. Note, no extract flag +go run hack/e2e.go -- --build --up # Most common. Note, no extract flag +go run hack/e2e.go -- --build --stage=gs://foo/bar --extract=local --up # Extract the staged version +``` ### Bringing up a cluster for testing |