Skip to content

Commit

Permalink
Merge pull request #9770 from hakman/squash-rel-notes
Browse files Browse the repository at this point in the history
Squash patch versions of old release notes
  • Loading branch information
k8s-ci-robot authored Aug 19, 2020
2 parents ee366e8 + 83740f5 commit 548beeb
Show file tree
Hide file tree
Showing 10 changed files with 140 additions and 136 deletions.
File renamed without changes.
112 changes: 105 additions & 7 deletions docs/releases/1.6-NOTES.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,117 @@
# Known Issues
# 1.6.2

* Kubernetes upgrade from 1.5 -> 1.6 requires a configmap to be created in the kube-system namespace to minimize downtime. If `kubectl -n kube-system get configmap kube-dns` does not already have a configmap, BEFORE upgrade you can execute `kubectl create configmap -n kube-system kube-dns`.
* Kubernetes changed taints from an annotation in 1.5, to a field in 1.6. Editing the taints by hand is a workaround for any issues. See: [#2594](https://github.com/kubernetes/kops/issues/2594)
* Some Kubernetes upgrades from 1.6.x -> 1.6.x have experience issues with secrets and service accounts. Deleting the secrets have been a workaround (not validated). See: #2576
## Significant changes

* Upgrade to weave 1.9.8 fixes issues with NodePorts

## Full changelist

* Weave upgraded to 1.9.8, to fix NodePort issue (thanks @jordanjennings, @justinsb)
* Fixes for (experimental) k8s.local DNS-free configurations (thanks @justinsb)
* Weave now configured with the correct pod CIDR (thanks @jordanjennings)
* Initial support for kube-router networking (thanks @murali-reddy)
* Apply cloud-labels to EBS volumes (thanks @pastjean)
* Support empty `--resolv-conf` (thanks @austinmoore-)
* Add --subnet and --role flags to create ig command (thanks @dtan4)
* Improvements to `kops delete` output (thanks @chrislovecnm)
* Match type (public/private) of DNS zones when matching (thanks @justinsb)
* CoreOS command now finds the latest image (thanks @gianrubio)
* Protokube now checks if kubelet is already running before calling systemctl start (thanks @aledbf)
* Added index to make documentation much easier to navigate (thanks @WillemMali)
* Makefile improvements (thanks @WillemMali)
* Refactor instance group / rolling-update code (thanks @andrewsykim)
* Lots of documentation and polish (thanks @chrislovecnm, @cordoval, @justinsb, @WillemMali)

---

## Fixed in 1.6.1
# 1.6.1

## Significant changes

* Calico users have noticed problems using Calico with Kubernetes 1.6
* "hairpin" connections back to the same pod were causing issues for CNI providers

## Full changelist

* `kops get` can now output a complete cluster spec (thanks @geojaz)
* `kops create` can set master/node volume size (thanks @matthew-marchetti)
* Add ability to set cross-subnet mode in Calico (thanks @ottoyiu)
* Make Weave MTU configurable and configure jumbo frame support for new clusters on AWS (thanks @jordanjennings)
* Initial support for external-dns project (thanks @sethpollack)
* Fix calico bootstrapping problems (thanks @ottoyiu, @ozdanborne)
* Update to latest release of calico (thanks @mad01)
* Update canal manifests for 1.6 & RBAC (thanks @heschlie)
* Mark calico-node pods as critical (thanks @andreychernih)
* Fix log rotation of apiserver audit logs (thanks @ottoyiu)
* Update cluster autoscaler addon (thanks @sethpollack)
* Set hairpin mode for flannel (thanks @justinsb)
* Fix GCE disk cleanup on cluster deletion (thanks @andrewsykim)
* Prevent "unbound variable" errors in `kops-mfa` (thanks @hugocf)
* Fix e2e tests for kubernetes 1.8 and 1.9 (thanks @justinsb)
* Fix directory permissions for `.kube` directory on master (thanks @chrislovecnm)
* Lots of documentation and polish (thanks @andrewsykim, @caarlos0, @chrislovecnm, @gianrubio, @Grillz, @justinsb, @mikesplain, @Shimi, @tanner-bruce, @WillemMali, @zanhsieh)

---

## Fixed in 1.6.2
# 1.6.0

* Upgrade to weave 1.9.8 fixes issues with NodePorts
## Known Issues

* Kubernetes upgrade from 1.5 -> 1.6 requires a configmap to be created in the kube-system namespace to minimize downtime. If `kubectl -n kube-system get configmap kube-dns` does not already have a configmap, BEFORE upgrade you can execute `kubectl create configmap -n kube-system kube-dns`.
* Kubernetes changed taints from an annotation in 1.5, to a field in 1.6. Editing the taints by hand is a workaround for any issues. See: [#2594](https://github.com/kubernetes/kops/issues/2594)
* Some Kubernetes upgrades from 1.6.x -> 1.6.x have experience issues with secrets and service accounts. Deleting the secrets have been a workaround (not validated). See: #2576

---

# 1.6.0-alpha.1

1.6.0-alpha.1 is a prerelease early-access of kops 1.6, which is the release with full support for kubernetes 1.6.
This version of kops & kubernetes has not yet undergone extensive validation, and there will be improvements
made before release of kops 1.6.0.

This is not a full set of release notes, but rather a summary of the highest impact changes in the 1.6 release:

* RBAC can be enabled by passing the `--authorization=rbac` parameter to `kops create cluster`,
or via `kops edit cluster` and change `authorization` from `alwaysAllow: {}` to `rbac: {}`

* The standard RBAC policy for 1.6 means that all access to the Kubernetes API using the default
service account method will be denied.

* The taints & tolerations have changed as part of their graduation from alpha. The taint is now a field on the node:

```yaml
spec:
taints:
- effect: NoSchedule
key: node-role.kubernetes.io/master
```
An example toleration (as used in dns-controller) is:
```yaml
spec:
tolerations:
- effect: NoSchedule
key: node-role.kubernetes.io/master
```
Note that the annotation form is ignored. To schedule a pod on the master, the toleration must be updated
and moved from an annotation to the field.
* A new label for nodes, mirroring the toleration, is added and is now preferred: `node-role.kubernetes.io/master=`
(`node-role.kubernetes.io/master` with an empty value). `kubernetes.io/role=master` is still present, but
the `node-role.kubernetes.io/<role>=` form is preferred. `kubernetes.io/role=node` and `node-role.kubernetes.io/node=`
are also present.

Workaround: create the configmap with `kubectl create configmap -n kube-system kube-dns` before updating.

## Known Issues

##### Rolling updates

Rolling update to 1.6 does not succeed because new kube-dns pods mount a configmap with an optional volume map,
but that is enforced by the kubelets, which are upgraded after the master.

##### etcd3

`kops` is not yet recommending etcd3. We do however support a **run at your own risk** option. Right now we are working on resolving issues such as HA upgrade support.
52 changes: 0 additions & 52 deletions docs/releases/1.6.0-alpha.1.md

This file was deleted.

24 changes: 0 additions & 24 deletions docs/releases/1.6.1.md

This file was deleted.

18 changes: 0 additions & 18 deletions docs/releases/1.6.2.md

This file was deleted.

23 changes: 18 additions & 5 deletions docs/releases/1.7-NOTES.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,19 @@
This document describes changes in the kops 1.7 release (compared to the 1.6 release)
# 1.7.1

# Significant changes
## Significant changes

* kube-dns has been updated with the hotfix for CVE-2017-14491. For more details, please see [CVE Advisory](../advisories/cve_2017_14491.md).

## Full changelist

* Update images in CI tests (thanks @justinsb)
* Update kube-dns to 1.14.5 for CVE-2017-14491 (thanks @mikesplain)

---

# 1.7.0

## Significant changes

* Manifests are rewritten by default, which includes a normalization phase.
This can make it hard to understand the actual changes (as opposed to just the formatting changes).
Expand All @@ -14,13 +27,13 @@ This document describes changes in the kops 1.7 release (compared to the 1.6 rel
* Default disk size increased to 64GB (masters) and 128GB (nodes). This does have a higher cost, but also gives us more inodes & more iops (and more disk space, of course!)
* Calico now configured with the correct pod CIDR: #2768. Please refer to the *Required Actions* section for details regarding this.

# Required Actions
## Required Actions

* Existing Calico users on clusters that were created prior to kops 1.7 are susceptible to IP conflict between Pods and Services due to an overlap of the two IP ranges. Migration to a new Pod CIDR is recommended, and is a manual procedure due to risk of potential downtime during this operation. For the migration procedure, please refer to [this document](../upgrade_from_kops_1.6_to_1.7_calico_cidr_migration.md).
* Existing Calico users on clusters that were created prior to kops 1.7 are susceptible to IP conflict between Pods and Services due to an overlap of the two IP ranges. Migration to a new Pod CIDR is recommended, and is a manual procedure due to risk of potential downtime during this operation.



# Full changelist
## Full changelist

* alpha channel: Bump k8s version to 1.6.6 [@justinsb](https://github.com/justinsb) [#2788](https://github.com/kubernetes/kops/pull/2788)
* Add release notes for 1.6.2 [@justinsb](https://github.com/justinsb) [#2786](https://github.com/kubernetes/kops/pull/2786)
Expand Down
13 changes: 0 additions & 13 deletions docs/releases/1.7.1.md

This file was deleted.

19 changes: 15 additions & 4 deletions docs/releases/1.8-NOTES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# 1.8.1

# Significant changes
Small patch release, which updates network plugins, but also tolerates a new schema file that will be added in kops 1.9.0. This will provide a downgrade option from kops 1.9.0.

* Ignore keyset.yaml files; provide a downgrade option from (upcoming) kops 1.9.0
* Update flannel, weave, romana, kopeio-networking, calico, canal
* Stop passing deprecated require-kubeconfig flag for kubernetes >= 1.9

---

# 1.8.0

## Significant changes

* flannel now has a `backend` property in the manifest, which can be either `udp` or `vxlan`. `udp`
is not recommended, but will be the default value for existing clusters or clusters created via manifests.
Expand All @@ -21,7 +32,7 @@

* Includes fix for kube-dns CVE-2017-14491 (was also included in kops 1.7.1)

# Required Actions
## Required Actions

* Existing Calico users on clusters that were created prior to kops 1.8.0
need to be updated for the new "DefaultDeny" behavior for Kubernetes NetworkPolicies.
Expand All @@ -36,7 +47,7 @@
5. Confirm cluster is back up and all canal pods are running successfully: `kops validate cluster` (this may take a few minutes for the cluster to fully validate)
6. Delete the upgrade job as it is no longer required: `kubectl delete job calico-upgrade-v2.5` (you can also safely delete the `clusterrole`, `clusterrolebinding` and `serviceaccount` resources that were created by the above manifest file)

# Highlighted changes
## Highlighted changes

* Support for etcd3 for new clusters, also allow etcd TLS to be enabled for new clusters. etcd peer port is also locked down.

Expand Down Expand Up @@ -109,7 +120,7 @@ or specify a different network (current using `--vpc` flag)
* building code using bazel


# All PRs
## All PRs


### to beta.1
Expand Down
6 changes: 0 additions & 6 deletions docs/releases/1.8.1.md

This file was deleted.

9 changes: 2 additions & 7 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -158,12 +158,7 @@ nav:
- "1.11": releases/1.11-NOTES.md
- "1.10": releases/1.10-NOTES.md
- "1.9": releases/1.9-NOTES.md
- "1.8.1": releases/1.8.1.md
- "1.8": releases/1.8-NOTES.md
- "1.7.1": releases/1.7.1.md
- "1.7": releases/1.7-NOTES.md
- "1.6.2": releases/1.6.2.md
- "1.6.1": releases/1.6.1.md
- "1.6.0": releases/1.6-NOTES.md
- "1.6.0-alpha": releases/1.6.0-alpha.1.md
- Legacy: releases/legacy-changes.md
- "1.6": releases/1.6-NOTES.md
- "1.4": releases/1.4-NOTES.md

0 comments on commit 548beeb

Please sign in to comment.