Skip to content

Commit 20194b9

Browse files
authored
Merge pull request #6461 from fedebongio/patch-1
Update annual-report-2021.md
2 parents 1c84a67 + a2f389f commit 20194b9

File tree

1 file changed

+140
-49
lines changed

1 file changed

+140
-49
lines changed

sig-api-machinery/annual-report-2021.md

Lines changed: 140 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,15 @@
44

55
1. What work did the SIG do this year that should be highlighted?
66

7-
-
8-
-
9-
-
7+
- Server Side Apply promoted to GA
8+
- Deprecated v1beta1 of Custom Resources and Webhooks (in favor of GA version)
9+
- API Priority and Fairness introduced v1beta2
10+
- A massive amount of improvements in the API Expression WG
1011

1112
2. What initiatives are you working on that aren't being tracked in KEPs?
1213

13-
-
14-
-
15-
-
14+
- We are evaluating long term the potential benefits that generics in go1.19 could provide.
15+
1616

1717
3. KEP work in 2021 (1.x, 1.y, 1.z):
1818

@@ -22,6 +22,8 @@ In future, this will be generated from kubernetes/enhancements kep.yaml files
2222
2. listing 1.x, 1.y, or 1.z in milestones or in latest-milestone
2323
-->
2424

25+
Need to pull from https://github.com/kubernetes/enhancements/issues?q=is%3Aissue+label%3Asig%2Fapi-machinery+updated%3A%3E%3D2021-01-01+is%3Aclosed
26+
2527
- Stable
2628
- [$kep-number - $title](https://git.k8s.io/community/$link/README.md) - $milestone.stable
2729
- [$kep-number - $title](https://git.k8s.io/community/$link/README.md) - $milestone.stable
@@ -38,43 +40,60 @@ In future, this will be generated from kubernetes/enhancements kep.yaml files
3840

3941
1. What areas and/or subprojects does your group need the most help with?
4042
Any areas with 2 or fewer OWNERs? (link to more details)
43+
44+
The SIG sponsors some working groups that are largely independent.
45+
46+
There are several areas where regularly the SIG becomes under pressure, especially closer to code freezes and the
47+
vast amount of code owned by API Machinery.
4148

42-
-
43-
-
44-
-
49+
The ecosystem of the different Kubernetes Clients that we own grows more or less organically. Client-go and
50+
Python-client are probably the bigger ones.
51+
52+
There are some packages that API Machinery owns and come out usually in our triage meetings, and that we most likely
53+
don't know much about: this happens often when Kubernetes is upgrading libraries for example.
54+
55+
Technical support for triages could have improvements, for example sometimes we remove API Machinery in PRs, and every update to the issue / pr get's us re- tagged again.
4556

4657
2. What metrics/community health stats does your group care about and/or measure?
4758

48-
-
49-
-
50-
-
59+
On the technical health of the SIG, we look at
60+
- the ratio of open/close PRs
61+
- the ratio of open/close Issues
62+
- overall age of open Issues
63+
- Number of active contributors to the sig
64+
65+
On the inclusion health of the SIG, we look at:
66+
- representation of diversity and of multiple companies in the sig participants
5167

5268
3. Does your [CONTRIBUTING.md] help **new** contributors engage with your group specifically by pointing
5369
to activities or programs that provide useful context or allow easy participation?
5470

55-
-
71+
- No, it can be improved. Usually we find many contributors via slack, PRs, and issues.
72+
5673

5774
4. If your group has special training, requirements for reviewers/approvers, or processes beyond the general [contributor guide],
5875
does your [CONTRIBUTING.md] document those to help **existing** contributors grow throughout the [contributor ladder]?
5976

60-
-
77+
- No, it can be improved. The main concern has always been the large amount of investment that is required to ramp up new contributors
6178

6279
5. Does the group have contributors from multiple companies/affiliations?
6380

64-
-
65-
81+
Yes, there are contributors from [multiple companies](https://k8s.devstats.cncf.io/d/74/contributions-chart?orgId=1&var-period=d7&var-metric=contributions&var-repogroup_name=SIG%20API%20Machinery&var-country_name=All&var-company_name=All&var-company=all).
82+
We see all sorts of contributions, varying from issues, to comments, to PRs, to designs, to sig meeting participation,
83+
and user-survey data.
84+
6685
6. Are there ways end users/companies can contribute that they currently are not?
6786
If one of those ways is more full time support, what would they work on and why?
6887

69-
-
70-
-
88+
- This is a topic that appears frequently. API Machinery owns ~40% of the Kubernetes code base. In the past, we had some newcomers show up in SIG meetings with very concrete support questions. This is not the right forum, and that is not what we want to turn those meetings into.
89+
- There is plenty of areas were the SIG could use help in reviewing and maintaining the code, but it's a complicated code base to ramp up. If people don't stick around long enough, the effort does not make sense.
7190

7291
## Membership
7392

74-
- Primary slack channel member count:
75-
- Primary mailing list member count:
76-
- Primary meeting attendee count (estimated, if needed):
77-
- Primary meeting participant count (estimated, if needed):
93+
- Primary slack channel member count: 3,384
94+
- Primary mailing list member count: 689
95+
- Primary meeting attendee count (estimated, if needed): 30
96+
- Primary meeting participant count (estimated, if needed): 10
7897
- Unique reviewers for SIG-owned packages: <!-- in future, this will be generated from OWNERS files referenced from subprojects, expanded with OWNERS_ALIASES files -->
7998
- Unique approvers for SIG-owned packages: <!-- in future, this will be generated from OWNERS files referenced from subprojects, expanded with OWNERS_ALIASES files -->
8099

@@ -87,17 +106,93 @@ In future, this will be generated from delta of sigs.yaml from $YYYY-01-01 to $Y
87106
Manually visible via `git diff HEAD@{$YYYY-01-01} HEAD@{$YYYY-12-31} -- $sig-id/README.md`
88107
-->
89108

90-
New in $YYYY:
91-
- [$subproject-name](https://git.k8s.io/community/$sig-id#$subproject-name)
92-
-
93-
94-
Retired in $YYYY:
95-
- [$subproject-name](https://git.k8s.io/community/$sig-id#$subproject-name)
96-
-
97-
98109
Continuing:
99-
- [$subproject-name](https://git.k8s.io/community/$sig-id#$subproject-name)
100-
-
110+
The following [subprojects][subproject-definition] are owned by sig-api-machinery:
111+
### component-base
112+
- **Owners:**
113+
- [kubernetes-sigs/legacyflag](https://github.com/kubernetes-sigs/legacyflag/blob/master/OWNERS)
114+
- [kubernetes/component-base](https://github.com/kubernetes/component-base/blob/master/OWNERS)
115+
- [kubernetes/kubernetes/staging/src/k8s.io/component-base](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/component-base/OWNERS)
116+
- [kubernetes/kubernetes/staging/src/k8s.io/component-base/version](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/component-base/version/OWNERS)
117+
### control-plane-features
118+
- **Owners:**
119+
- [kubernetes-sigs/kube-storage-version-migrator](https://github.com/kubernetes-sigs/kube-storage-version-migrator/blob/master/OWNERS)
120+
- [kubernetes-sigs/kubectl-check-ownerreferences](https://github.com/kubernetes-sigs/kubectl-check-ownerreferences/blob/master/OWNERS)
121+
- [kubernetes/kubernetes/pkg/controller/garbagecollector](https://github.com/kubernetes/kubernetes/blob/master/pkg/controller/garbagecollector/OWNERS)
122+
- [kubernetes/kubernetes/pkg/controller/namespace](https://github.com/kubernetes/kubernetes/blob/master/pkg/controller/namespace/OWNERS)
123+
- [kubernetes/kubernetes/pkg/controller/resourcequota](https://github.com/kubernetes/kubernetes/blob/master/pkg/controller/resourcequota/OWNERS)
124+
- [kubernetes/kubernetes/pkg/quota/v1](https://github.com/kubernetes/kubernetes/blob/master/pkg/quota/v1/OWNERS)
125+
### idl-schema-client-pipeline
126+
- **Owners:**
127+
- [kubernetes-client/gen](https://github.com/kubernetes-client/gen/blob/master/OWNERS)
128+
- [kubernetes-sigs/structured-merge-diff](https://github.com/kubernetes-sigs/structured-merge-diff/blob/master/OWNERS)
129+
- [kubernetes/code-generator](https://github.com/kubernetes/code-generator/blob/master/OWNERS)
130+
- [kubernetes/gengo](https://github.com/kubernetes/gengo/blob/master/OWNERS)
131+
- [kubernetes/kube-openapi](https://github.com/kubernetes/kube-openapi/blob/master/OWNERS)
132+
- [kubernetes/kubernetes/staging/src/k8s.io/code-generator](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/code-generator/OWNERS)
133+
### json
134+
- **Owners:**
135+
- [kubernetes-sigs/json](https://github.com/kubernetes-sigs/json/blob/main/OWNERS)
136+
### kubernetes-clients
137+
- **Owners:**
138+
- [kubernetes-client/c](https://github.com/kubernetes-client/c/blob/master/OWNERS)
139+
- [kubernetes-client/csharp](https://github.com/kubernetes-client/csharp/blob/master/OWNERS)
140+
- [kubernetes-client/go-base](https://github.com/kubernetes-client/go-base/blob/master/OWNERS)
141+
- [kubernetes-client/go](https://github.com/kubernetes-client/go/blob/master/OWNERS)
142+
- [kubernetes-client/haskell](https://github.com/kubernetes-client/haskell/blob/master/OWNERS)
143+
- [kubernetes-client/java](https://github.com/kubernetes-client/java/blob/master/OWNERS)
144+
- [kubernetes-client/javascript](https://github.com/kubernetes-client/javascript/blob/master/OWNERS)
145+
- [kubernetes-client/perl](https://github.com/kubernetes-client/perl/blob/master/OWNERS)
146+
- [kubernetes-client/python-base](https://github.com/kubernetes-client/python-base/blob/master/OWNERS)
147+
- [kubernetes-client/python](https://github.com/kubernetes-client/python/blob/master/OWNERS)
148+
- [kubernetes-client/ruby](https://github.com/kubernetes-client/ruby/blob/master/OWNERS)
149+
- [kubernetes-sigs/clientgofix](https://github.com/kubernetes-sigs/clientgofix/blob/master/OWNERS)
150+
- [kubernetes/client-go](https://github.com/kubernetes/client-go/blob/master/OWNERS)
151+
- [kubernetes/kubernetes/staging/src/k8s.io/client-go](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/client-go/OWNERS)
152+
### server-api-aggregation
153+
- **Owners:**
154+
- [kubernetes/kube-aggregator](https://github.com/kubernetes/kube-aggregator/blob/master/OWNERS)
155+
- [kubernetes/kubernetes/staging/src/k8s.io/kube-aggregator](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/kube-aggregator/OWNERS)
156+
### server-binaries
157+
- **Owners:**
158+
- [kubernetes/kubernetes/cmd/cloud-controller-manager](https://github.com/kubernetes/kubernetes/blob/master/cmd/cloud-controller-manager/OWNERS)
159+
- [kubernetes/kubernetes/cmd/kube-apiserver](https://github.com/kubernetes/kubernetes/blob/master/cmd/kube-apiserver/OWNERS)
160+
- [kubernetes/kubernetes/cmd/kube-controller-manager](https://github.com/kubernetes/kubernetes/blob/master/cmd/kube-controller-manager/OWNERS)
161+
- [kubernetes/kubernetes/pkg/kubeapiserver](https://github.com/kubernetes/kubernetes/blob/master/pkg/kubeapiserver/OWNERS)
162+
- [kubernetes/kubernetes/pkg/master](https://github.com/kubernetes/kubernetes/blob/master/pkg/master/OWNERS)
163+
- [kubernetes/kubernetes/staging/src/k8s.io/controller-manager](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/controller-manager/OWNERS)
164+
### server-crd
165+
- **Owners:**
166+
- [kubernetes/apiextensions-apiserver](https://github.com/kubernetes/apiextensions-apiserver/blob/master/OWNERS)
167+
- [kubernetes/kubernetes/staging/src/k8s.io/apiextensions-apiserver](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apiextensions-apiserver/OWNERS)
168+
### server-frameworks
169+
- **Owners:**
170+
- [kubernetes/apiserver](https://github.com/kubernetes/apiserver/blob/master/OWNERS)
171+
- [kubernetes/controller-manager](https://github.com/kubernetes/controller-manager/blob/master/OWNERS)
172+
- [kubernetes/kubernetes/staging/src/k8s.io/apiserver](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apiserver/OWNERS)
173+
- [kubernetes/kubernetes/staging/src/k8s.io/controller-manager](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/controller-manager/OWNERS)
174+
### server-sdk
175+
- **Owners:**
176+
- [kubernetes-sigs/apiserver-builder-alpha](https://github.com/kubernetes-sigs/apiserver-builder-alpha/blob/master/OWNERS)
177+
- [kubernetes-sigs/apiserver-runtime](https://github.com/kubernetes-sigs/apiserver-runtime/blob/master/OWNERS)
178+
- [kubernetes-sigs/controller-runtime](https://github.com/kubernetes-sigs/controller-runtime/blob/master/OWNERS)
179+
- [kubernetes-sigs/controller-tools](https://github.com/kubernetes-sigs/controller-tools/blob/master/OWNERS)
180+
- [kubernetes-sigs/kubebuilder-declarative-pattern](https://github.com/kubernetes-sigs/kubebuilder-declarative-pattern/blob/master/OWNERS)
181+
- [kubernetes-sigs/kubebuilder-release-tools](https://github.com/kubernetes-sigs/kubebuilder-release-tools/blob/master/OWNERS)
182+
- [kubernetes-sigs/kubebuilder](https://github.com/kubernetes-sigs/kubebuilder/blob/master/OWNERS)
183+
- [kubernetes/kubernetes/staging/src/k8s.io/sample-apiserver](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/sample-apiserver/OWNERS)
184+
- [kubernetes/kubernetes/staging/src/k8s.io/sample-controller](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/sample-controller/OWNERS)
185+
- [kubernetes/sample-apiserver](https://github.com/kubernetes/sample-apiserver/blob/master/OWNERS)
186+
- [kubernetes/sample-controller](https://github.com/kubernetes/sample-controller/blob/master/OWNERS)
187+
- **Contact:**
188+
- [Mailing List](https://groups.google.com/forum/#!forum/kubebuilder)
189+
### universal-machinery
190+
- **Owners:**
191+
- [kubernetes/apimachinery](https://github.com/kubernetes/apimachinery/blob/master/OWNERS)
192+
- [kubernetes/kubernetes/staging/src/k8s.io/apimachinery](https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/OWNERS)
193+
### yaml
194+
- **Owners:**
195+
- [kubernetes-sigs/yaml](https://github.com/kubernetes-sigs/yaml/blob/master/OWNERS)
101196

102197
## Working groups
103198

@@ -106,32 +201,28 @@ In future, this will be generated from delta of sigs.yaml from $YYYY-01-01 to $Y
106201
Manually visible via `git diff HEAD@{$YYYY-01-01} HEAD@{$YYYY-12-31} -- $sig-id/README.md`
107202
-->
108203

109-
New in $YYYY:
110-
- [$wg-name](https://git.k8s.io/community/$wg-id/) ([$YYYY report](https://git.k8s.io/community/$wg-id/annual-report-$YYYY.md))
111-
-
204+
Continuing:
205+
The following working groups are sponsored by sig-api-machinery:
112206

113-
Retired in $YYYY:
114-
- [$wg-name](https://git.k8s.io/community/$wg-id/) ([$YYYY report](https://git.k8s.io/community/$wg-id/annual-report-$YYYY.md))
115-
-
207+
- [WG API Expression](https://github.com/kubernetes/community/tree/master/wg-api-expression)
208+
- [WG Multitenancy](https://github.com/kubernetes/community/tree/master/wg-multitenancy)
209+
- [WG Structured Logging](https://github.com/kubernetes/community/tree/master/wg-structured-logging)
116210

117-
Continuing:
118-
- [$wg-name](https://git.k8s.io/community/$wg-id/) ([$YYYY report](https://git.k8s.io/community/$wg-id/annual-report-$YYYY.md))
119-
-
120211

121212
## Operational
122213

123214
Operational tasks in [sig-governance.md]:
124215

125-
- [ ] [README.md] reviewed for accuracy and updated if needed
126-
- [ ] [CONTRIBUTING.md] reviewed for accuracy and updated if needed
216+
- [x] [README.md] reviewed for accuracy and updated if needed
217+
- [x] [CONTRIBUTING.md] reviewed for accuracy and updated if needed
127218
(or created if missing and your contributor steps and experience are different or more
128219
in-depth than the documentation listed in the general [contributor guide] and [devel] folder.)
129-
- [ ] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed
130-
- [ ] SIG leaders (chairs, tech leads, and subproject owners) in [sigs.yaml] are accurate and active, and updated if needed
131-
- [ ] Meeting notes and recordings for 2021 are linked from [README.md] and updated/uploaded if needed
132-
- [ ] Did you have community-wide updates in 2021 (e.g. community meetings, kubecon, or kubernetes-dev@ emails)? Links to email, slides, or recordings:
133-
-
134-
-
220+
- [x] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed
221+
- [x] SIG leaders (chairs, tech leads, and subproject owners) in [sigs.yaml] are accurate and active, and updated if needed
222+
- [x] Meeting notes and recordings for 2021 are linked from [README.md] and updated/uploaded if needed
223+
- [x] Did you have community-wide updates in 2021 (e.g. community meetings, kubecon, or kubernetes-dev@ emails)? Links to email, slides, or recordings:
224+
- [Kubecon NA 2021](https://www.youtube.com/watch?v=oiC2w1PVjrQ)
225+
- [Community update](https://docs.google.com/presentation/d/1UWRaMVtTD3yVhJ3MGBpt7LRIaRHTaQZoGlDT7Bl7jLE/edit#slide=id.g401c104a3c_0_0)
135226

136227
[CONTRIBUTING.md]: https://git.k8s.io/community/sig-api-machinery/CONTRIBUTING.md
137228
[contributor ladder]: https://git.k8s.io/community/community-membership.md

0 commit comments

Comments
 (0)