kubernetes / kubernetes/website

Document cluster resilience around upgrade

Open
#42,712 4 comments 0 reactions 0 assignees View on GitHub
kind/feature language/en lifecycle/frozen needs-triage sig/architecture sig/cluster-lifecycle
Dominant language
HTML
Stars
5.4k
Forks
15.7k
Avg merge
4d 18h
Merged PRs (30d)
204

Description

**This is a Feature Request**

**What would you like to be added**
Add details about how to maintain resilience for your Kubernetes cluster during an upgrade.

**Why is this needed**
We have https://kubernetes.io/docs/tasks/administer-cluster/cluster-upgrade/#upgrade-other as a task-oriented guide but it doesn't tell you much about the design considerations and constraints.

_**For example**_ if you upgrade etcd then a 3-node etc cluster is briefly unable to tolerate some forms of partial outage (the surviving node cannot detect that it is the sole healthy survivor). You could set up a witness / fencing mechanism; a more cloud native approach is to scale it out to 5 nodes, do the upgrade and scale in.

**Comments**
Aim to cover the [mixed version proxy](https://kubernetes.io/docs/concepts/architecture/mixed-version-proxy/) concept; in fact, we could move that page to be a heading in a new page if we add one.

/sig cluster-lifecycle
/sig architecture

/language en
/kind feature

Contributor guide

Open the contributing guide

Research direction

Start with the existing cluster upgrade task page and the mixed version proxy page named in the issue. Read how those pages describe upgrades, then outline the design considerations and constraints for maintaining cluster resilience, including the etcd example. Done means a documented page or section that covers these considerations and the mixed version proxy concept.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
documentation, infrastructure
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.