Easy, automated upgrades with the kubeadm upgrade command

[lukemarsden]

Feature Description

• One-line feature description (can be used as a release note): A new command, kubeadm upgrade, allows you to automatically upgrade a cluster created by kubeadm
• Primary contact (assignee): @lukemarsden, @luxas
• Responsible SIGs: SIG-cluster-lifecycle
• Design proposal link (community repo):
  • https://docs.google.com/document/d/1PRrC2tvB-p7sotIA5rnHy5WAOGdJJOIXPPv23hUFGrY/edit
  • [WIP] Add kubeadm upgrades proposal community#825
• Reviewer(s) - (for LGTM) recommend having 2+ reviewers (at least one from code-area OWNERS file) agreed to review. Reviewers from multiple companies preferred: @luxas @jbeda
• Approver (likely from SIG/area to which feature belongs):
• Feature target (which target equals to which milestone):
  • Alpha release target (1.7): https://kubernetes.io/docs/tasks/administer-cluster/kubeadm-upgrade-1-7/
  • Beta release target (1.8 & 1.9): [WIP] Add kubeadm upgrades proposal community#825
  • Stable release target: 1.12

[idvoretskyi]

@lukemarsden the feature freeze for 1.7 has already gone (on Monday, May 1).

[lukemarsden]

@idvoretskyi yes, sorry – I've been slammed after DockerCon. I've been chatting to @calebamiles who said it might be possible to make an exception for this, please 🙏

[calebamiles]

I think this work was already scheduled by the SIG, @idvoretskyi the issue was simply filed late which I don't think is a huge deal.

[luxas]

Yeah, this has been planned for a while, thanks @calebamiles!

[idvoretskyi]

@lukemarsden @luxas sounds good to me, thanks.

[lukemarsden]

Making a call on this – we're not going to make it for 1.7. Let's bump this to 1.8. Sorry.

cc @idvoretskyi

[timothysc]

@lukemarsden is there a WIP fork or issue on this somewhere? Just wondering what the current state is.

[lukemarsden]

@timothysc nope, no code yet.

[luxas]

For subscribers of this thread, I've now written up kind of a new proposal for how to achieve this. see here: https://docs.google.com/document/d/1PRrC2tvB-p7sotIA5rnHy5WAOGdJJOIXPPv23hUFGrY

Feedback welcome, coding is expected to start next week-ish.

[luxas]

This will be beta in v1.8, our alpha was the kubeadm v1.6-v1.7 upgrade route: https://kubernetes.io/docs/tasks/administer-cluster/kubeadm-upgrade-1-7/

The upgrades proposal in markdown format: kubernetes/community#825

I also updated the first comment to correctly reflect the status of this feature.

[justaugustus]

@timothysc @luxas
Any plans for this in 1.11?

If so, can you please ensure the feature is up-to-date with the appropriate:

• Description
• Milestone
• Assignee(s)
• Labels:
  • stage/{alpha,beta,stable}
  • sig/*
  • kind/feature

cc @idvoretskyi

[luxas]

@justaugustus this feature won't move to GA yet, we're improving it incrementally in the beta state.

/lifecycle frozen

[justaugustus]

/remove-lifecycle frozen

[luxas]

This will be graduated at the same time kubeadm itself goes GA: #11

[justaugustus]

This feature current has no milestone, so we'd like to check in and see if there are any plans for this in Kubernetes 1.12.

If so, please ensure that this issue is up-to-date with ALL of the following information:

• One-line feature description (can be used as a release note):
• Primary contact (assignee):
• Responsible SIGs:
• Design proposal link (community repo):
• Link to e2e and/or unit tests:
• Reviewer(s) - (for LGTM) recommend having 2+ reviewers (at least one from code-area OWNERS file) agreed to review. Reviewers from multiple companies preferred:
• Approver (likely from SIG/area to which feature belongs):
• Feature target (which target equals to which milestone):
  • Alpha release target (x.y)
  • Beta release target (x.y)
  • Stable release target (x.y)

Set the following:

• Description
• Assignee(s)
• Labels:
  • stage/{alpha,beta,stable}
  • sig/*
  • kind/feature

Once this feature is appropriately updated, please explicitly ping @justaugustus, @kacole2, @robertsandoval, @rajendar38 to note that it is ready to be included in the Features Tracking Spreadsheet for Kubernetes 1.12.

---

Please note that Features Freeze is tomorrow, July 31st, after which any incomplete Feature issues will require an Exception request to be accepted into the milestone.

In addition, please be aware of the following relevant deadlines:

• Docs deadline (open placeholder PRs): 8/21
• Test case freeze: 8/28

Please make sure all PRs for features have relevant release notes included as well.

Happy shipping!

P.S. This was sent via automation

[justaugustus]

/kind feature
/stage stable

[justaugustus]

Tracking as GA for 1.12

[zparnold]

Hey there! @lukemarsden I'm the wrangler for the Docs this release. Is there any chance I could have you open up a docs PR against the release-1.12 branch as a placeholder? That gives us more confidence in the feature shipping in this release and gives me something to work with when we start doing reviews/edits. Thanks! If this feature does not require docs, could you please update the features tracking spreadsheet to reflect it?

[justaugustus]

@lukemarsden, @luxas @timothysc --
Any update on docs status for this feature? Are we still planning to land it for 1.12?
At this point, code freeze is upon us, and docs are due on 9/7 (2 days).
If we don't here anything back regarding this feature ASAP, we'll need to remove it from the milestone.

cc: @zparnold @jimangel @tfogo

[neolit123]

for this one, upgrades are already useful and the docs are in place for 1.11:
https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm-upgrade/
https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-11/

there are still some question marks in terms of implementation and we have some tracking issues in k/kubeadm.

the KEP for this seems to be still in flight:
kubernetes/community#825

also, we don't have placeholder docs for 1.12, yet.

[timothysc]

We're aiming for GA in 1.13 at this point.

[justaugustus]

Thanks for the update, @timothysc !

[kacole2]

@timothysc i'm curious if this should just be rolled into #11 and tracked there since it's all going GA at the same time. Or is it better to track kubeadm features separately? Are kubeadm upgrades still targeting 1.13?

[timothysc]

Closing in favor of #11 .

We are in the final stages now of moving towards GA.