Skip to content

Commit

Permalink
docs: add Go versioning policy
Browse files Browse the repository at this point in the history
  • Loading branch information
schmichael committed Jan 27, 2020
1 parent 7892903 commit 15ecd0c
Show file tree
Hide file tree
Showing 3 changed files with 35 additions and 0 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ FEATURES:

IMPROVEMENTS:

* build: Updated to Go 1.12.15 [[GH-6950](https://github.com/hashicorp/nomad/issues/6950)]
* cli: Added option to change the name of the file created by the `nomad init` command [[GH-6520]](https://github.com/hashicorp/nomad/pull/6520)
* cli: Included namespace in output when querying job stauts. [[GH-6912](https://github.com/hashicorp/nomad/issues/6912)]
* scheduler: Removed penalty for allocation's previous node if the allocation did not fail. [[GH-6781](https://github.com/hashicorp/nomad/issues/6781)]
Expand Down
4 changes: 4 additions & 0 deletions contributing/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,3 +39,7 @@ developers and reviewers confidence that the proper changes have been made:
* [New `jobspec` entry](checklist-jobspec.md)
* [New CLI command](checklist-command.md)
* [New RPC endpoint](checklist-rpc-endpoint.md)

## Tooling

* [Go tool versions](golang.md)
30 changes: 30 additions & 0 deletions contributing/golang.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Nomad Go Version

Nomad is intended to be built with a specific version of the Go toolchain for
each release. Generally, each Y release of Nomad (where 0.9.5 means X=0, Y=9,
Z=5) will update to the latest version of the Go toolchain available at the
time.

Nomad Z releases update to the latest Go Z release but do *not* change Go's Y
version.

## Version Table

| Nomad Version | Go Version |
|:-------------:|:----------:|
| 0.11 | 1.13 |
| 0.10 | 1.12 |
| 0.9 | 1.11 |

## Code

The
[`update_golang_version.sh`](https://github.com/hashicorp/nomad/blob/master/scripts/update_golang_version.sh)
script is used to update the Go version for all build tools.

The [Changelog](https://github.com/hashicorp/nomad/blob/v0.10.2/CHANGELOG.md)
will note when the Go version has changed in the Improvements section:

```
* build: Updated to Go 1.12.13 [GH-6606]
```

0 comments on commit 15ecd0c

Please sign in to comment.