summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKubernetes Submit Queue <k8s-merge-robot@users.noreply.github.com>2016-08-09 20:14:19 -0700
committerGitHub <noreply@github.com>2016-08-09 20:14:19 -0700
commit7214e0a0c4c59c561c726d77e75680e6e7ea583e (patch)
tree44f90834171a5179682ef5d64c091e5bba658e67
parent2db30bd01f2412771f8b5764da2edf37486afa71 (diff)
parent79328b29c6294ca3e12ce6163f125728a62b4ad9 (diff)
Merge pull request #29200 from jfrazelle/update-devel-docs-for-where-to-up-go-version
Automatic merge from submit-queue Update the devel docs with where and how to change the go version Update the devel docs with where and how to change the go version being used to build and test k8s. <!-- Reviewable:start --> --- This change is [<img src="https://reviewable.kubernetes.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.kubernetes.io/reviews/kubernetes/kubernetes/29200) <!-- Reviewable:end -->
-rw-r--r--development.md17
-rw-r--r--go-code.md2
2 files changed, 19 insertions, 0 deletions
diff --git a/development.md b/development.md
index 32cb17cb..1275a0a5 100644
--- a/development.md
+++ b/development.md
@@ -88,6 +88,21 @@ To build binaries for all platforms:
make cross
```
+### How to update the Go version used to test & build k8s
+
+The kubernetes project tries to stay on the latest version of Go so it can
+benefit from the improvements to the language over time and can easily
+bump to a minor release version for security updates.
+
+Since kubernetes is mostly built and tested in containers, there are a few
+unique places you need to update the go version.
+
+- The image for cross compiling in [build/build-image/cross/](../../build/build-image/cross/). The `VERSION` file and `Dockerfile`.
+- The jenkins test-image in
+ [hack/jenkins/test-image/](../../hack/jenkins/test-image/). The `Dockerfile` and `Makefile`.
+- The docker image being run in [hack/jenkins/dockerized-e2e-runner.sh](../../hack/jenkins/dockerized-e2e-runner.sh) and [hack/jenkins/gotest-dockerized.sh](../../hack/jenkins/gotest-dockerized.sh).
+- The cross tag `KUBE_BUILD_IMAGE_CROSS_TAG` in [build/common.sh](../../build/common.sh)
+
## Workflow
Below, we outline one of the more common git workflows that core developers use.
@@ -340,6 +355,8 @@ hack/update-generated-docs.sh
```
+
+
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/devel/development.md?pixel)]()
<!-- END MUNGE: GENERATED_ANALYTICS -->
diff --git a/go-code.md b/go-code.md
index 01b9c45c..e6416bed 100644
--- a/go-code.md
+++ b/go-code.md
@@ -36,6 +36,8 @@ and tips that our developers have found useful.
## Recommended Reading
- [Kubernetes Go development environment](development.md#go-development-environment)
+- [The Go Spec](https://golang.org/ref/spec) - The Go Programming Language
+ Specification.
- [Go Tour](https://tour.golang.org/welcome/2) - Official Go tutorial.
- [Effective Go](https://golang.org/doc/effective_go.html) - A good collection of Go advice.
- [Kubernetes Code conventions](coding-conventions.md) - Style guide for Kubernetes code.