Skip to content
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

Merged
merged 5 commits into from
Oct 19, 2018
Merged

Conversation

spiffxp
Copy link
Member

@spiffxp spiffxp commented Oct 9, 2018

/cc @fejta @stevekuznetsov @timothysc
sig chairs

FYI @kubernetes/sig-testing

@k8s-ci-robot k8s-ci-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 9, 2018
@k8s-ci-robot k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Oct 9, 2018
@k8s-ci-robot k8s-ci-robot requested a review from timothysc October 9, 2018 18:45
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. sig/testing Categorizes an issue or PR as relevant to SIG Testing. labels Oct 9, 2018
- 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
Copy link
Member

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?

Copy link
Member Author

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
Copy link
Member Author

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


- 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
Copy link
Member Author

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

Copy link
Member Author

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

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
Copy link
Member Author

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

Copy link
Contributor

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
Copy link
Member Author

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]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+boskos?

Copy link
Member Author

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?

Copy link
Member

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)

Copy link
Member Author

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]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+planter?

Copy link
Member Author

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

Copy link
Member

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.

Copy link
Member Author

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


#### Cross-cutting and Externally Facing Processes

- The Release Team [test-infra role] is staffed by a memer of SIG Testing, as
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/memer/member

Copy link
Member

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

🙃


## Roles and Organization Management

This sig follows adheres to the Roles and Organization Management outlined in
Copy link
Member

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.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack



[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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is unused.

Copy link
Member Author

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].
Copy link
Member

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?

Copy link
Member Author

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

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
Copy link
Contributor

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?

[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
Copy link
Contributor

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

## 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
Copy link
Member

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...

Copy link
Contributor

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.

Copy link
Member Author

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.

- 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],
Copy link
Member

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?

Copy link
Member Author

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.


- 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
Copy link
Member

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.

- 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]
Copy link
Member

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

[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
Copy link
Member

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:/

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack


#### Cross-cutting and Externally Facing Processes

- The Release Team [test-infra role] is staffed by a memer of SIG Testing, as
Copy link
Member

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

@spiffxp
Copy link
Member Author

spiffxp commented Oct 11, 2018

/committee steering

@k8s-ci-robot k8s-ci-robot added the committee/steering Denotes an issue or PR intended to be handled by the steering committee. label Oct 11, 2018
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Oct 13, 2018
@spiffxp spiffxp force-pushed the sig-testing-charter branch from fbda4a5 to 553d5d1 Compare October 13, 2018 22:17
@spiffxp
Copy link
Member Author

spiffxp commented Oct 13, 2018

/hold
because I'm going to remove the wip

PTAL, I consider this ready to ask steering to review if there are no more objections

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 13, 2018
@spiffxp spiffxp changed the title [wip] Initial stab at SIG Testing charter Add SIG Testing charter Oct 13, 2018
@neolit123
Copy link
Member

SGTM, nice to see a good charter that will merge fast.

@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Oct 16, 2018
@spiffxp
Copy link
Member Author

spiffxp commented Oct 16, 2018

/assign @dims @brendandburns
For steering committee review

@spiffxp spiffxp force-pushed the sig-testing-charter branch from c4fb635 to 0bac6c6 Compare October 16, 2018 18:45
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.
Copy link
Member

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!)

Copy link
Member Author

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.

Copy link
Member

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.

Copy link
Contributor

@fejta fejta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm
/hold

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Oct 16, 2018
@dims
Copy link
Member

dims commented Oct 17, 2018

/lgtm

@dims
Copy link
Member

dims commented Oct 17, 2018

@brendandburns This looks like its good to go

@cblecker
Copy link
Member

cblecker commented Oct 17, 2018

Haven't had a chance to look through this until now. Fantastic work! I love it.

Copy link
Contributor

@brendandburns brendandburns left a 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.

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,
Copy link
Contributor

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"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done


### Out of scope

- We are not responsible for troubleshooting or writing tests or jobs for
Copy link
Contributor

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.

Copy link
Member Author

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

[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
Copy link
Contributor

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?

Copy link
Member Author

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

@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Oct 18, 2018
@spiffxp
Copy link
Member Author

spiffxp commented Oct 18, 2018

@brendandburns updated, PTAL

@dims
Copy link
Member

dims commented Oct 19, 2018

/lgtm

reads well.

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Oct 19, 2018
- 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
Copy link
Member

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.

@timothysc
Copy link
Member

nice work, LGTM from me.

@spiffxp
Copy link
Member Author

spiffxp commented Oct 19, 2018

/approve
self-approving

brendanburns [5:03 PM]
I'll try to look tonight, but if I don't feel free to merge w/o my response

@k8s-ci-robot
Copy link
Contributor

[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 /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Oct 19, 2018
@spiffxp
Copy link
Member Author

spiffxp commented Oct 19, 2018

/hold cancel
Forgot to remove the /hold as well

@k8s-ci-robot k8s-ci-robot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 19, 2018
@k8s-ci-robot k8s-ci-robot merged commit f54169e into kubernetes:master Oct 19, 2018
@spiffxp spiffxp deleted the sig-testing-charter branch October 19, 2018 18:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. committee/steering Denotes an issue or PR intended to be handled by the steering committee. lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/testing Categorizes an issue or PR as relevant to SIG Testing. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.