summaryrefslogtreecommitdiff
path: root/wg-reliability/charter.md
blob: 699e09bbd9c9f33c1bd0e8ae2ab54f13ba06e9d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# WG Reliability Charter

This charter adheres to the conventions described in the [Kubernetes Charter README]
and uses the Roles and Organization Management outlined in [sig-governance].

[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md
[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md

## Scope

The Reliability Working Group (WG Reliability) is organized with the goal of 
allowing users to safely use Kubernetes for managing production workloads by
ensuring Kubernetes is stable and reliable.

### In Scope

- What reliability means for Kubernetes and how to measure it?
- Measuring Kubernetes reliability in tests
- Introducing criteria for blocking the release if the reliability is
  below the bar
- Building a list of end-user outages and reliability issues
  (if applicable with mitigations and/or workarounds)
- Creating and prioritizing a list of areas that require reliability
  investments
- Work with relevant SIGs on delivering necessary infrastructure
  (e.g. test frameworks) to unblock further steps
- Initiate and drive cross-SIG reliability improvements

For all of the above, we will focus on core Kubernetes components and addons.
Other SIG subprojects/components (e.g. SIG Scheduling descheduler) are out of
scope.

### Out of scope

- Designing and executing on improvements clearly falling into individual SIG
  responsibilities.

## Special Powers

The Reliability WG will create a proposal that will allow blocking
feature-oriented contributions from any SIG if requested reliability-related
improvements are not being addressed. The exact criteria will have to be
approved by SIG Architecture, SIG Release, SIG Testing and automatically
enforced.

The exact scope of blocking hasn't yet been decided. There are at least two
high-level options: blocking PRs and blocking graduation of features.
Conformance vs everything enabled by default has to be explicitly defined).
As a result, the mechanics of blocking hasn't been decided as they will
heavily depend on the exact scope. As mentioned above, all of those will have
to be explicitly approved by SIGs mentioned above.

The blocking criteria (once approved) will be passed to SIG Architecture
Production Readiness subproject or SIG Architecture generally for reassignment
at the lead's discretion.

Note that ideally the criteria should be extendable to other areas (e.g.
security), but that's not the goal by itself.

## Stakeholders

Stakeholders in this working group span multiple SIGs.

In the first phase of defining reliability for Kubernetes building list of
reliability gaps and areas for investments the following SIGs will be
involved:

- SIG Architecture
  High-level input on requirements.
- SIG Scalability
  Input on scale test gaps and reliability issues at scale.
- SIG Cluster Lifecycle
  Input on cluster setup and upgrade mechanics.
- SIG Release
  Input on blocking and soak requirements.
- SIG Testing
  Input on testing mechanics, missing frameworks, etc.
- SIG *
  Input on reliability gaps in their areas.

The group will be also reaching out to users and cluster operator
(e.g. via surveys), to build the full picture. We will likely leverage
the CNCF end-user group for this purpose.

In the later phase improving reliability, every single SIG may potentially
be involved depending on the findings from the initial phase.

## Deliverables

The artifacts the group is supposed to deliver include:
- Document defining what reliability means for Kubernetes and how to measure it.
- List of known user outages and potential failure modes
- List of specific investmenets that should happen to improve reliability
- Set of processes to introduce in Kubernetes to avoid over time degradation
  of reliability

The actual investments will be owned by corresponding SIGs.

## Roles and Organization Management

This sig follows adheres to the Roles and Organization Management outlined in
[sig-governance] and opts-in to updates and modifications to [sig-governance].

[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md

## Timelines and Disbanding

The exact timeline for existing of this working group is hard to predict at
this time.

The group will start working on the deliverables mentioned above. Once the
group we will be satisfied with the current shape of them and no additional
coordination on their execution will be needed, we will retire Working Group
and pass oversight of reliability to SIG Architecture PRR subproject.