-
Notifications
You must be signed in to change notification settings - Fork 5.2k
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 SIG Testing charter #2777
Add SIG Testing charter #2777
Conversation
sig-testing/charter.md
Outdated
- We are not resonpsible for troubleshooting or writing tests or jobs for | ||
features owned by other SIGs | ||
- We are not responsible for ongoing maintenance of kubernetes' e2e test | ||
framework |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
just out of curiosity, is there any ongoing plan for the e2e framework?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
not at present, we had a long chat about this during the most recent sig-testing meeting, and are opting to keep it in scope but not really actively staffed, so I'd like to see if it's worth pointing this out here
|
||
### Deviations from [sig-governance] | ||
|
||
- Chairs also fulfill the role of Tech Lead |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For discussion: I've seen most SIGs do this but I think I'd rather see the roles explicitly split
sig-testing/charter.md
Outdated
|
||
- We are not resonpsible for troubleshooting or writing tests or jobs for | ||
features owned by other SIGs | ||
- We are not responsible for ongoing maintenance of kubernetes' e2e test |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For discussion: maybe this falls under the testing-commons subproject? But in terms of staffing I don't see ongoing maintenance
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
discussed during today's meeting, we'll call it out as owned by this sig, but unstaffed... to paraphrase the meeting, we know where at least some of the bodies are buried, but that doesn't mean there were no more bodies buried on top
sig-testing/charter.md
Outdated
the maintenance of release jobs | ||
- When rolling out changes that may potentially impact the project as a whole | ||
we consult with SIG Contributor Experience, and follow [lazy consensus] by | ||
notifying kubernetes-dev, providing a deadline,and a rationale for the |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For discussion: this is really squishy, how can we firm this up
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Seems accurate to the process we use, though -- do you mean we should firm up the process or this doc?
- Tools that facilitate local testing of kubernetes such as [greenhouse] | ||
and [kind] | ||
- Jobs that automate away project toil via [@fejta-bot] | ||
- Ensuring all of the above is kept running on a best effort basis |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For discussion: I eventually want this to go to the CNCF / infra WG once we have handed infra to them, but for now this is where it belongs IMO
- Display and analysis of test artifacts via tools like [gubernator], | ||
[testgrid], [triage] and [velodrome] | ||
- Configuration management of jobs and ensuring they use a consistent | ||
process via tools such as [job configs], [kubetest] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+boskos?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
would boskos fall here or under project CI w/ prow?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
boskos is not part of prow... it's built in with kubetest for gcp project provision, you can also write customer applications for other resource provision purposes, for example, cluster provisioning (mason)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added boskos to "infrastructure to support CI at scale"
- Configuration management of jobs and ensuring they use a consistent | ||
process via tools such as [job configs], [kubetest] | ||
- Tools that facilitate local testing of kubernetes such as [greenhouse] | ||
and [kind] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+planter?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ack, planter is what I meant, not greenhouse
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
greenhouse, github cache etc are probably also in scope under another area ~nebulously infrastructure / automation, not sure how many things we really need to call out though.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
replaced with planter and put greenhouse, boskos, ghproxy under a different bullet to support CI at our scale
sig-testing/charter.md
Outdated
|
||
#### Cross-cutting and Externally Facing Processes | ||
|
||
- The Release Team [test-infra role] is staffed by a memer of SIG Testing, as |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/memer/member
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I dunno I kinda like:
The Release Team [test-infra role] is staffed by a memer of SIG Testing
🙃
sig-testing/charter.md
Outdated
|
||
## Roles and Organization Management | ||
|
||
This sig follows adheres to the Roles and Organization Management outlined in |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: "follows adheres" is redundant.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ack
sig-testing/charter.md
Outdated
|
||
|
||
[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md | ||
[sig-subprojects]: https://github.com/kubernetes/community/blob/master/sig-YOURSIG/README.md#subprojects |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is unused.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ack, will delete
## 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]. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should these both be sig-governance
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this is copy-pasta from the template, but I think it makes sense to be explicit here
sig-testing/charter.md
Outdated
the maintenance of release jobs | ||
- When rolling out changes that may potentially impact the project as a whole | ||
we consult with SIG Contributor Experience, and follow [lazy consensus] by | ||
notifying kubernetes-dev, providing a deadline,and a rationale for the |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Seems accurate to the process we use, though -- do you mean we should firm up the process or this doc?
sig-testing/charter.md
Outdated
[kubetest]: https://git.k8s.io/test-infra/kubetest | ||
[kind]: https://github.com/kubernetes-sigs/kind | ||
[@fejta-bot]: https://github.com/fejta-bot | ||
[greenhouse]: https://git.k8s.io/test-infra/greenhouseu |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this should have been planter, but FYI the link is broken
sig-testing/charter.md
Outdated
## Scope | ||
|
||
SIG Testing is interested in effective testing of Kubernetes. We do not write or | ||
troubleshoot the project's tests, but instead focus on tooling that makes it |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We often do troubleshoot though...
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It should be presented as an act of goodwill, though, and best-effort.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm rewording to be a little more explicit that we should be the last ask, not the first ask, and our goal is remediation rather than owning a fix.
sig-testing/charter.md
Outdated
- Project CI and merge automation via tools such as [prow] and [tide] | ||
- Extraction of test results from GCS and populating a public accessible | ||
BigQuery dataset via [kettle] | ||
- Display and analysis of test artifacts via tools like [gubernator], |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Are all of the tools totally opensourced now? I thought parts of test-grid were still not open?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Open sourcing testgrid is still the plan, but for now I would file this under "services"
In terms of code, the open source pieces we own are yaml config, and the yaml->proto conversion code. I'm not sure whether we "own" all of the dashboards though. I would consider it analogous to how we own config management of jobs, but encourage individual owners to write their own jobs
We could consider testgrid a google-staffed subproject of sig-testing if there is concern that this places an undue burden on members who can't update all parts of its code.
sig-testing/charter.md
Outdated
|
||
- We are not resonpsible for troubleshooting or writing tests or jobs for | ||
features owned by other SIGs | ||
- We are not responsible for ongoing maintenance of kubernetes' e2e test |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would nix this statement, b/c it falls under the 1st part of the scope.
sig-testing/charter.md
Outdated
- Extraction of test results from GCS and populating a public accessible | ||
BigQuery dataset via [kettle] | ||
- Display and analysis of test artifacts via tools like [gubernator], | ||
[testgrid], [triage] and [velodrome] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
link for velodrome is missing
sig-testing/charter.md
Outdated
[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md | ||
|
||
[gubernator]: http://k8s-gubernator.appspot.com | ||
[kettle]: https:/git.k8s.io/test-infra/kettle |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
you're missing a /
after https:/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ack
sig-testing/charter.md
Outdated
|
||
#### Cross-cutting and Externally Facing Processes | ||
|
||
- The Release Team [test-infra role] is staffed by a memer of SIG Testing, as |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this link is also missing
/committee steering |
fbda4a5
to
553d5d1
Compare
/hold PTAL, I consider this ready to ask steering to review if there are no more objections |
SGTM, nice to see a good charter that will merge fast. |
/assign @dims @brendandburns |
c4fb635
to
0bac6c6
Compare
features or subprojects owned by other SIGs | ||
- We are not responsible for ongoing maintenance of the project's CI Signal, | ||
as this is driven by tests and jobs owned by other SIGs. We do however have | ||
an interest in producing tools to help improve the signal. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you want to add stuff like on-call are out of scope too?
Is there something you want to add about turn around times for things when they break? (can't guarantee is fine!)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I guess I'd rather not get too specific about it if I don't need to. I stated as "in scope" that we support our infrastructure on a best effort basis. I aspire for us to have more than that in terms of rigor or metrics, but this is where we are today.
If I have to spell it out, it would be something like:
- As stated above, we support and maintain the project's testing and automation infrastructure on a best effort basis. As such, we do not provide response time guarantees or off-hours support, though we do understand the importance of keeping a global high-traffic open source project moving.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
let's see if anyone else feels like it should be.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
/lgtm
/hold
/lgtm |
@brendandburns This looks like its good to go |
Haven't had a chance to look through this until now. Fantastic work! I love it. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Small stuff. Approved, but would love the cleanups.
sig-testing/charter.md
Outdated
contribute, analyze and act upon test results. | ||
|
||
We are not responsible for writing, fixing, nor actively troubleshooting the | ||
project's tests, as this is the responsibility of the respective test, feature, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
shorten to:
"is the responsibility of the owning SIG"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
sig-testing/charter.md
Outdated
|
||
### Out of scope | ||
|
||
- We are not responsible for troubleshooting or writing tests or jobs for |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is redundant with the statement in 'Scope' I'd put it in one place or the other but not both.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I want at least some kind of call out up top, but linked down here for the details
sig-testing/charter.md
Outdated
[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md | ||
[lazy consensus]: http://en.osswiki.info/concepts/lazy_consensus | ||
|
||
[@fejta-bot]: https://github.com/fejta-bot |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a pointer to a robot user. Is it really a sub-project? Maybe it really ought to be a pointer to the code behind the bot?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
redid to link to the periodic jobs
@brendandburns updated, PTAL |
/lgtm reads well. |
- Tools, frameworks and libraries that make it possible to write tests against | ||
kubernetes such as e2e\* or integration test frameworks. | ||
|
||
\* Note that while we are the current de facto owners of the kubernetes e2e |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is gr8, thx for the edit.
nice work, LGTM from me. |
/approve
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: spiffxp 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 |
/hold cancel |
/cc @fejta @stevekuznetsov @timothysc
sig chairs
FYI @kubernetes/sig-testing