Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add information on supported version skew and upgrade order #11060

Merged
merged 4 commits into from Dec 8, 2018

Conversation

@liggitt
Copy link
Member

liggitt commented Nov 18, 2018

Fixes #7103

Preview available at: https://deploy-preview-11060--kubernetes-io-master-staging.netlify.com/docs/setup/version-skew-policy/

We have a document that details the deprecation policy for APIs, but no document on the website detailing supported versions and version skew between Kubernetes components.

This is important information to make clear, for many reasons:

  • it has implications for component upgrade order
  • it is necessary for cluster deployers to know what the skew guarantees are so they know what to deploy
  • it is necessary for component owners to know what skew they are expected to support so they know what cases to handle
  • it is important for reviewers to know what changes are acceptable to make in a given release

This PR attempts to clarify the currently supported state of supported Kubernetes versions and component version skew.

I'd like to resolve the following questions, get feedback from various sigs, and merge this around the time 1.13 releases (and mention it in the release notes), currently targeted for 12/3.

follow-up discussion topics/updates:

references:

relevant owners for open questions:

@k8sio-netlify-preview-bot

This comment has been minimized.

Copy link
Collaborator

k8sio-netlify-preview-bot commented Nov 18, 2018

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 563d289

https://deploy-preview-11060--kubernetes-io-master-staging.netlify.com

@k8sio-netlify-preview-bot

This comment has been minimized.

Copy link
Collaborator

k8sio-netlify-preview-bot commented Nov 18, 2018

Deploy preview for kubernetes-io-master-staging ready!

Built with commit fc6f306

https://deploy-preview-11060--kubernetes-io-master-staging.netlify.com

@liggitt

This comment has been minimized.

Copy link
Member Author

liggitt commented Nov 18, 2018

assigning representatives from the various tagged sigs/components. please review or nominate an alternate.

/assign @justaugustus
representing sig-release

/assign @timothysc
representing cluster-lifecycle

/assign @bgrant0607 @smarterclayton
representing sig-architecture

/assign @thockin
for kube-proxy upgrade order question

/assign @soltysh
for kubectl

/assign @lavalamp
for kube-apiserver / kube-controller-manager

/assign @derekwaynecarr
for kubelet

@liggitt liggitt force-pushed the liggitt:skew branch 3 times, most recently from 1237fe4 to 5f7af58 Nov 18, 2018

@liggitt liggitt referenced this pull request Nov 18, 2018

Closed

Document supported component skew #7103

1 of 2 tasks complete
@neolit123
Copy link
Member

neolit123 left a comment

thanks a lot for this write up @liggitt
👍

Show resolved Hide resolved content/en/docs/setup/version-skew-policy.md Outdated
@spiffxp

This comment has been minimized.

Copy link
Member

spiffxp commented Dec 7, 2018

/unassign @timothysc
github only allows a max of 10 assignees per issue/pr, so I'm kicking off someone who already gave a +1 to make room for @mistyhacks

@spiffxp

This comment has been minimized.

Copy link
Member

spiffxp commented Dec 7, 2018

/assign @mistyhacks

@mistyhacks

This comment has been minimized.

Copy link
Member

mistyhacks commented Dec 8, 2018

/approve

I already did a review pass earlier, and we can iterate.

@k8s-ci-robot

This comment has been minimized.

Copy link

k8s-ci-robot commented Dec 8, 2018

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: bgrant0607, mistyhacks

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot merged commit 75ed07f into kubernetes:master Dec 8, 2018

4 checks passed

cla/linuxfoundation liggitt authorized
Details
continuous-integration/travis-ci/pr The Travis CI build passed
Details
deploy/netlify Deploy preview ready!
Details
tide In merge pool.
Details
@derekwaynecarr

This comment has been minimized.

Copy link
Member

derekwaynecarr commented Dec 8, 2018

noting this looked good for sig-node

kychool added a commit to kychool/website that referenced this pull request Dec 26, 2018

Add information on supported version skew and upgrade order (kubernet…
…es#11060)

* Add information on supported version skew and upgrade order

* address comments

* added cloud-controller-manager

* format headers

kychool added a commit to kychool/website that referenced this pull request Dec 26, 2018

Add information on supported version skew and upgrade order (kubernet…
…es#11060)

* Add information on supported version skew and upgrade order

* address comments

* added cloud-controller-manager

* format headers

immutableT added a commit to immutableT/website that referenced this pull request Jan 9, 2019

Add information on supported version skew and upgrade order (kubernet…
…es#11060)

* Add information on supported version skew and upgrade order

* address comments

* added cloud-controller-manager

* format headers

immutableT added a commit to immutableT/website that referenced this pull request Jan 9, 2019

Add information on supported version skew and upgrade order (kubernet…
…es#11060)

* Add information on supported version skew and upgrade order

* address comments

* added cloud-controller-manager

* format headers
@liggitt

This comment has been minimized.

Copy link
Member Author

liggitt commented Jan 22, 2019

opened follow-up issues to track individual items and created an umbrella issue at #12329

bsalamat added a commit to bsalamat/kubernetes.github.io that referenced this pull request Jan 29, 2019

Add information on supported version skew and upgrade order (kubernet…
…es#11060)

* Add information on supported version skew and upgrade order

* address comments

* added cloud-controller-manager

* format headers
@tpepper

This comment has been minimized.

Copy link

tpepper commented Mar 15, 2019

/wg lts

@k8s-ci-robot k8s-ci-robot added the wg/lts label Mar 15, 2019

@tpepper tpepper added this to Done in WG LTS Mar 15, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.