From fc3fc6aeb97d3a076ed7699c45c05bb692ca8830 Mon Sep 17 00:00:00 2001 From: Morgante Pell Date: Wed, 25 Sep 2019 18:09:50 -0400 Subject: [PATCH 1/2] Move old upgrading guide references to CHANGELOG --- CHANGELOG.md | 14 ++++++++++++++ README.md | 16 ---------------- 2 files changed, 14 insertions(+), 16 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fb8cf39f47..a6b5509726 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -48,6 +48,8 @@ The v5.0.0 module requires using the [2.12 version](https://github.com/terraform * Supported version of Terraform is 0.12. [#177] ## [v3.0.0] - 2019-07-08 +v3.0.0 is a breaking release. Refer to the +[Upgrading to v3.0 guide][upgrading-to-v3.0] for details. ### Added @@ -88,6 +90,8 @@ The v5.0.0 module requires using the [2.12 version](https://github.com/terraform 2.3. [#148] ## [v2.0.0] - 2019-04-12 +v2.0.0 is a breaking release. Refer to the +[Upgrading to v2.0 guide][upgrading-to-v2.0] for details. ### Added @@ -119,6 +123,10 @@ The v5.0.0 module requires using the [2.12 version](https://github.com/terraform * Fix empty zone list. [#132] ## [v1.0.0] - 2019-03-25 +Version 1.0.0 of this module introduces a breaking change: adding the `disable-legacy-endpoints` metadata field to all node pools. This metadata is required by GKE and [determines whether the `/0.1/` and `/v1beta1/` paths are available in the nodes' metadata server](https://cloud.google.com/kubernetes-engine/docs/how-to/protecting-cluster-metadata#disable-legacy-apis). If your applications do not require access to the node's metadata server, you can leave the default value of `true` provided by the module. If your applications require access to the metadata server, be sure to read the linked documentation to see if you need to set the value for this field to `false` to allow your applications access to the above metadata server paths. + +In either case, upgrading to module version `v1.0.0` will trigger a recreation of all node pools in the cluster. + ### Added * Allow creation of service accounts. [#80] * Add support for private clusters via submodule. [#69] @@ -251,3 +259,9 @@ The v5.0.0 module requires using the [2.12 version](https://github.com/terraform [#15]: https://github.com/terraform-google-modules/terraform-google-kubernetes-engine/issues/15 [#10]: https://github.com/terraform-google-modules/terraform-google-kubernetes-engine/pull/10 [#9]: https://github.com/terraform-google-modules/terraform-google-kubernetes-engine/pull/9 + +[upgrading-to-v2.0]: docs/upgrading_to_v2.0.md +[upgrading-to-v3.0]: docs/upgrading_to_v3.0.md +[terraform-provider-google]: https://github.com/terraform-providers/terraform-provider-google +[3.0.0]: https://registry.terraform.io/modules/terraform-google-modules/kubernetes-engine/google/3.0.0 +[terraform-0.12-upgrade]: https://www.terraform.io/upgrade-guides/0-12.html diff --git a/README.md b/README.md index 923d3f7a09..afa0cac122 100644 --- a/README.md +++ b/README.md @@ -108,22 +108,6 @@ Then perform the following commands on the root folder: - `terraform apply` to apply the infrastructure build - `terraform destroy` to destroy the built infrastructure -## Upgrade to v3.0.0 - -v3.0.0 is a breaking release. Refer to the -[Upgrading to v3.0 guide][upgrading-to-v3.0] for details. - -## Upgrade to v2.0.0 - -v2.0.0 is a breaking release. Refer to the -[Upgrading to v2.0 guide][upgrading-to-v2.0] for details. - -## Upgrade to v1.0.0 - -Version 1.0.0 of this module introduces a breaking change: adding the `disable-legacy-endpoints` metadata field to all node pools. This metadata is required by GKE and [determines whether the `/0.1/` and `/v1beta1/` paths are available in the nodes' metadata server](https://cloud.google.com/kubernetes-engine/docs/how-to/protecting-cluster-metadata#disable-legacy-apis). If your applications do not require access to the node's metadata server, you can leave the default value of `true` provided by the module. If your applications require access to the metadata server, be sure to read the linked documentation to see if you need to set the value for this field to `false` to allow your applications access to the above metadata server paths. - -In either case, upgrading to module version `v1.0.0` will trigger a recreation of all node pools in the cluster. - ## Inputs From 86523c4148048c6c5d977280fd6332cdbeb16308 Mon Sep 17 00:00:00 2001 From: Morgante Pell Date: Wed, 25 Sep 2019 18:11:22 -0400 Subject: [PATCH 2/2] Tag v5.0.0 --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a6b5509726..9200790618 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,7 @@ Extending the adopted spec, each change should have a link to its corresponding ## [Unreleased] -## [v5.0.0] - 2019-XX-XX +## [v5.0.0] - 2019-09-25 v5.0.0 is a backwards-incompatible release. Please see the [upgrading guide](./docs/upgrading_to_v5.0.md). The v5.0.0 module requires using the [2.12 version](https://github.com/terraform-providers/terraform-provider-google/blob/master/CHANGELOG.md#2120-august-01-2019) of the Google provider.