From 96ba398a4060d6ad836f25151ee8341d31514eea Mon Sep 17 00:00:00 2001 From: David Zhu Date: Fri, 22 Feb 2019 15:08:30 -0800 Subject: [PATCH 01/34] Volume Reconstruction migration design --- .../design-proposals/storage/csi-migration.md | 24 ++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/contributors/design-proposals/storage/csi-migration.md b/contributors/design-proposals/storage/csi-migration.md index 5aa7411c5..db5a01420 100644 --- a/contributors/design-proposals/storage/csi-migration.md +++ b/contributors/design-proposals/storage/csi-migration.md @@ -268,7 +268,29 @@ TODO: Design ### Volume Reconstruction -TODO: Design +Volume Reconstruction is currently a routine in the reconciler that runs on the +nodes when a Kubelet restarts and loses its cached state (`desiredState` and +`actualState`). It is kicked off in `syncStates()` in +`pkg/kubeletvolumemanager/reconciler/reconciler.go` and attempts to reconstruct +a volume based on the mount path on the host machine. + +When CSI Migration is turned on, when the reconstruction code is run and it +finds a CSI mounted volume we currently do not know whether it was mounted as a +native CSI volume or migrated from in-tree. To solve this issue we will save a +`migratedVolume` boolean in the `saveVolumeData` function when the `NewMounter` +is created during the `MountVolume` call for that particular volume in the +Operation generator. + +When the Kubelet is restarted and we lose state the Kubelet will call +`reconstructVolume` we can `loadVolumeData` and determine whether that CSI +volume was migrated or not, as well as get the information about the original +plugin requested. With that information we should be able to call the +`ReconstructVolumeOperation` with the correct in-tree plugin to get the original +in-tree spec that we can then pass to the rest of volume reconstruction. The +rest of the volume reconstruction code will then use this in-tree spec passed to +the `desiredState`, `actualState`, and `operationGenerator` and the volume will +go through the standard volume pathways and go through the standard migrated +volume lifecycles described above in the "Pre-Provisioned Volumes" section. ### Volume Limit From 9cfba52ce4344d6f6ffe9aa2a4046d6a9e9da252 Mon Sep 17 00:00:00 2001 From: Andrew Kim Date: Wed, 6 Mar 2019 16:26:01 -0500 Subject: [PATCH 02/34] updates to SIG Cloud Provider charter --- sig-cloud-provider/CHARTER.md | 136 +++++++++++++--------------------- 1 file changed, 52 insertions(+), 84 deletions(-) diff --git a/sig-cloud-provider/CHARTER.md b/sig-cloud-provider/CHARTER.md index e4dc78f78..30f050520 100644 --- a/sig-cloud-provider/CHARTER.md +++ b/sig-cloud-provider/CHARTER.md @@ -1,100 +1,68 @@ # SIG Cloud Provider Charter -## Mission -The Cloud Provider SIG ensures that the Kubernetes ecosystem is evolving in a way that is neutral to all (public and private) cloud providers. It will be responsible for establishing standards and requirements that must be met by all providers to ensure optimal integration with Kubernetes. +This charter adheres to the conventions described in the [Kubernetes Charter README] and uses +the Roles and Organization Management outlined in [sig-governance]. -## Subprojects & Areas of Focus +## Scope -* Maintaining parts of the Kubernetes project that allows Kubernetes to integrate with the underlying provider. This includes but are not limited to: - * [cloud provider interface](https://github.com/kubernetes/kubernetes/blob/master/pkg/cloudprovider/cloud.go) - * [cloud-controller-manager](https://github.com/kubernetes/kubernetes/tree/master/cmd/cloud-controller-manager) - * Deployment tooling which has historically resided under [cluster/](https://github.com/kubernetes/kubernetes/tree/release-1.11/cluster) -* Code ownership for all cloud providers that fall under the kubernetes organization and have opted to be subprojects of SIG Cloud Provider. Following the guidelines around subprojects we anticipate providers will have full autonomy to maintain their own repositories, however, official code ownership will still belong to SIG Cloud Provider. - * [cloud-provider-azure](https://github.com/kubernetes/cloud-provider-azure) - * [cloud-provider-gcp](https://github.com/kubernetes/cloud-provider-gcp) - * [cloud-provider-openstack](https://github.com/kubernetes/cloud-provider-openstack) - * [cloud-provider-vsphere](https://github.com/kubernetes/cloud-provider-vsphere) -* Standards for documentation that should be included by all providers. -* Defining processes/standards for E2E tests that should be reported by all providers -* Developing future functionality in Kubernetes to support use cases common to all providers while also allowing custom and pluggable implementations when required, some examples include but are not limited to: - * Extendable node status’ and machine states based on provider - * Extendable node address types based on provider - * See also [Cloud Controller Manager KEP](https://github.com/kubernetes/community/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md) -* The collection of user experience reports from Kubernetes operators running on provider subprojects; and the delivery of roadmap information to SIG PM +SIG Cloud Provider’s mission is to simplify, develop, and maintain cloud provider integrations as extensions, or add-ons, to Kubernetes clusters. -## Organizational Management +### In scope -* Six months after this charter is first ratified, it MUST be reviewed and re-approved by the SIG in order to evaluate the assumptions made in its initial drafting -* SIG meets bi-weekly on zoom with agenda in meeting notes. - * SHOULD be facilitated by chairs unless delegated to specific Members -* The SIG MUST make a best effort to provide leadership opportunities to individuals who represent different races, national origins, ethnicities, genders, abilities, sexual preferences, ages, backgrounds, levels of educational achievement, and socioeconomic statuses +#### Areas of Focus -## Subproject Creation +- Extension points between Kubernetes and any cloud provider +- APIs/interfaces for efficiently provisioning/de-provisioning cloud resources (nodes, routes, load balancers, etc) +- Configuration of cluster components to enable cloud provider integrations +- Testing and testing frameworks to ensure vendor neutrality across all cloud providers -Each Kubernetes provider will (eventually) be a subproject under SIG Cloud Provider. To add new sub projects (providers), SIG Cloud Provider will maintain an open list of requirements that must be satisfied. -The current requirements can be seen [here](https://github.com/kubernetes/community/blob/master/keps/sig-cloud-provider/0002-cloud-controller-manager.md#repository-requirements). Each provider subproject is entitled to create 1..N repositories related to cluster turn up or operation on their platform, subject to technical standards set by SIG Cloud Provider. -Creation of a repository SHOULD follow the KEP process to preserve the motivation for the repository and any additional instructions for how other SIGs (e.g SIG Documentation and SIG Release) should interact with the repository +#### Code, Binaries and Services -Subprojects that fall under SIG Cloud Provider may also be features in Kubernetes that is requested or needed by all, or at least a large majority of providers. The creation process for these subprojects will follow the usual KEP process. +- the [common interfaces](https://github.com/kubernetes/cloud-provider/blob/master/cloud.go) consumed by all cloud providers +- the [cloud-controller-manager](https://github.com/kubernetes/kubernetes/tree/master/cmd/cloud-controller-manager), which acts as the “out-of-tree” cloud provider component for clusters. +- core controllers (started by the cloud-controller-manager) that interact with cloud provider resources +- all [cloud provider repositories](https://github.com/kubernetes?utf8=%E2%9C%93&q=cloud-provider-&type=&language=) under the Kubernetes organization +- [e2e tests for cloud provider specific](https://github.com/kubernetes/kubernetes/tree/master/test/e2e/cloud) functionality -## Subproject Retirement +#### Cross-cutting and Externally Facing Processes -Subprojects representing Kubernetes providers may be retired given they do not satisfy requirements for more than 6 months. Final decisions for retirement should be supported by a majority of SIG members using [lazy consensus](http://en.osswiki.info/concepts/lazy_consensus). Once retired any code related to that provider will be archived into the kubernetes-retired organization. +- This SIG works with SIG Testing & SIG Release to ensure that cloud providers are actively testing & reporting test results to testgrid. +- This SIG works with SIG Docs to provide user-facing documentation on configuring Kubernetes clusters with cloud provider integration enabled. +- This SIG works with new cloud providers in the ecosystem that want to host their code in the Kubernetes organization and have an interest in contributing back. +- This SIG actively engages with SIGs owning other external components of Kubernetes (CNI, CSI, etc) to ensure a consistent integration story for users. -Subprojects representing Kubernetes features may be retired at any point given a lack of development or a lack of demand. Final decisions for retirement should be supported by a majority of SIG members, ideally from every provider. Once retired, any code related to that subproject will be archived into the kubernetes-retired organization. +### Out of scope + +- This SIG does not act as a line of support for Kubernetes users running their clusters on any cloud provider, though many members of the SIG represent cloud providers and are actively engaged with users. +- This SIG does not address features/bugs pertaining to cloud providers outside the scope of Kubernetes integrations (e.g. when will instance type X be available on cloud provider Y?) + +## 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]. + +### Additional responsibilities of Chairs + +- Selecting/prioritizing work to be done for a milestone +- Hosting the weekly SIG meeting, ensure that recordings are uploaded in a timely fashion. +- Ensuring that the breakout sessions the SIG hosts during the week have chairs. +- Organizing SIG sessions at KubeCon events (intro / deep dive sessions). +- Creating roadmaps for a given year or release, or reviewing and approving technical implementation plans (e.g. KEPs) in coordination with both SIG Cluster Lifecycle contributors and other SIGs. + +### Deviations from [sig-governance] + +- There should be no more than 1 chair from a single company. This ensures decisions are not being made in favor of a single provider/company. +- As SIG cloud provider contains a number of subprojects, the SIG has empowered subproject leads with a number of additional responsibilities, including but not limited to: + * Releases: The subproject owners are responsible for determining the subproject release cadence, producing releases, and communicating releases with SIG Release and any other relevant SIG. + * Backlog grooming: The subproject owners are responsible for ensuring that the issues for the subproject are correctly associated with milestones and that bugs are triaged in a timely manner. +PR timeliness: The subproject owners are responsible for ensuring that active pull requests for the subproject are addressed in a timely manner. + * Repository ownership: The subproject owners are given admin permissions to repositories under the subproject. For example, the owners of the Azure subproject are given admin access to the `k8s.io/cloud-provider-azure` repository. -## Technical Processes -Subprojects (providers) of the SIG MUST use the following processes unless explicitly following alternatives they have defined. +### Subproject Creation -* Proposals will be sent as [KEP](https://git.k8s.io/enhancements/keps/YYYYMMDD-kep-template.md) PRs, and published to the official group mailing list as an announcement -* Proposals, once submitted, SHOULD be placed on the next full meeting agenda -* Decisions within the scope of individual subprojects should be made by lazy consensus by subproject owners, with fallback to majority vote by subproject owners; if a decision can’t be made, it should be escalated to the SIG Chairs -* Issues impacting multiple subprojects in the SIG should be resolved by consensus of the owners of the involved subprojects; if a decision can’t be made, it should be escalated to the SIG Chairs - -## Roles -The following roles are required for the SIG to function properly. In the event that any role is unfilled, the SIG will make a best effort to fill it. Any decisions reliant on a missing role will be postponed until the role is filled. - - -### Chairs -* 3 chairs are required -* Run operations and processes governing the SIG -* An initial set of chairs was established at the time the SIG was founded. -* Chairs MAY decide to step down at anytime and propose a replacement, who must be approved by all of the other chairs. This SHOULD be supported by a majority of SIG Members. -* Chairs MAY select additional chairs using lazy consensus amongst SIG Members. -* Chairs MUST remain active in the role and are automatically removed from the position if they are unresponsive for > 3 months and MAY be removed by consensus of the other Chairs and members if not proactively working with other Chairs to fulfill responsibilities. -* Chairs WILL be asked to step down if there is inappropriate behavior or code of conduct issues -* SIG Cloud Provider cannot have more than one chair from any one company. - -### Subproject/Provider Owners -* There should be at least 1 representative per subproject/provider (though 3 is recommended to avoid deadlock) as specified in the OWNERS file of each cloud provider repository. -* MUST be an escalation point for technical discussions and decisions in the subproject/provider -* MUST set milestone priorities or delegate this responsibility -* MUST remain active in the role and are automatically removed from the position if they are unresponsive for > 3 months and MAY be removed by consensus of other subproject owners and Chairs if not proactively working with other Subproject Owners to fulfill responsibilities. -* MAY decide to step down at anytime and propose a replacement. This can be done by updating the OWNERS file for any subprojects. -* MAY select additional subproject owners by updating the OWNERs file. -* WILL be asked to step down if there is inappropriate behavior or code of conduct issues - -### SIG Members - -Approvers and reviewers in the OWNERS file of all subprojects under SIG Cloud Provider. - -## Long Term Goals - -The long term goal of SIG Cloud Provider is to promote a vendor neutral ecosystem for our community. Vendors wanting to support Kubernetes should feel equally empowered to do so -as any of today’s existing cloud providers; but more importantly ensuring a high quality user experience across providers. The SIG will act as a central group for developing -the Kubernetes project in a way that ensures all providers share common privileges and responsibilities. Below are some concrete goals on how SIG Cloud Provider plans to accomplish this. - -### Consolidating Existing Cloud SIGs - -SIG Cloud Provider will aim to eventually consolidate existing cloud provider SIGs and have each provider instead form a subproject under it. The subprojects would drive the development of -individual providers and work closely with SIG Cloud Provider to ensure compatibility with Kubernetes. With this model, code ownership for new and existing providers will belong to SIG Cloud Provider, -limiting SIG sprawl as more providers support Kubernetes. Existing SIGs representing cloud providers are highly encouraged to opt-in as sub-projects under SIG Cloud Provider but are not required to do. -As a SIG opts-in, it will operate to ensure a smooth transition, typically over the course of 3 release cycles. - -### Supporting New Cloud Providers - -One of the primary goals of SIG Cloud Provider is to become an entrypoint for new providers wishing to support Kubernetes on their platform and ensuring technical excellence from each of those providers. -SIG Cloud Provider will accomplish this by maintaining documentation around how new providers can get started and managing the set of requirements that must be met to onboard them. In addition to -onboarding new providers, the entire lifecycle of providers would also fall under the responsibility of SIG Cloud Provider, which may involve clean up work if a provider decides to no longer support Kubernetes. +Federation of Subprojects +[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 +[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md From be0f96ffadc0ff8dd2cec61e59716683a25d58c9 Mon Sep 17 00:00:00 2001 From: Cheng Pan Date: Thu, 14 Mar 2019 00:24:17 +0000 Subject: [PATCH 03/34] Update CSI migration doc for block volume migration --- contributors/design-proposals/storage/csi-migration.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/contributors/design-proposals/storage/csi-migration.md b/contributors/design-proposals/storage/csi-migration.md index ee6dc464c..6990d30cd 100644 --- a/contributors/design-proposals/storage/csi-migration.md +++ b/contributors/design-proposals/storage/csi-migration.md @@ -292,8 +292,14 @@ existing Pods in the ADC. TODO: Design ### Raw Block +In the OperationGenerator, `GenerateMapVolumeFunc`, `GenerateUnmapVolumeFunc` and +`GenerateUnmapDeviceFunc` are used to prepare and mount/umount block devices. At the +beginning of each API, we will check whether migration is enabled for the plugin. If +enabled, volume spec will be translated from the in-tree spec to out-of-tree spec using +CSI as the persistence volume source. -TODO: Design +Caveat: the original spec needs to be used when setting the state of `actualStateOfWorld` +for where is it used before the translation. ### Volume Reconstruction From b41c2b6f3ee883f3c31c0c15f514ac874c98a7cc Mon Sep 17 00:00:00 2001 From: Ahmet Alp Balkan Date: Thu, 14 Mar 2019 10:41:06 -0700 Subject: [PATCH 04/34] Add SIG CLI subprojects krew and krew-index reference: https://github.com/kubernetes/org/issues/599 Signed-off-by: Ahmet Alp Balkan --- sig-cli/README.md | 8 ++++++++ sigs.yaml | 9 ++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/sig-cli/README.md b/sig-cli/README.md index a82c20e1d..f3821b03a 100644 --- a/sig-cli/README.md +++ b/sig-cli/README.md @@ -58,6 +58,14 @@ The following subprojects are owned by sig-cli: - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/cli-runtime/OWNERS - https://raw.githubusercontent.com/kubernetes/sample-cli-plugin/master/OWNERS - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/sample-cli-plugin/OWNERS +- **krew** + - Description: Plugin manager for kubectl. + - Owners: + - https://raw.githubusercontent.com/kubernetes-sigs/krew/master/OWNERS +- **krew-index** + - Description: Centralized plugin index for krew. + - Owners: + - https://raw.githubusercontent.com/kubernetes-sigs/krew-index/master/OWNERS ## GitHub Teams diff --git a/sigs.yaml b/sigs.yaml index 278eda5f5..715f9b3e0 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -708,7 +708,6 @@ sigs: - https://raw.githubusercontent.com/kubernetes/kubernetes/master/pkg/kubectl/OWNERS - name: kustomize owners: - # "owners" entry - https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/OWNERS - name: cli-sdk owners: @@ -716,6 +715,14 @@ sigs: - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/cli-runtime/OWNERS - https://raw.githubusercontent.com/kubernetes/sample-cli-plugin/master/OWNERS - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/sample-cli-plugin/OWNERS + - name: krew + description: Plugin manager for kubectl. + owners: + - https://raw.githubusercontent.com/kubernetes-sigs/krew/master/OWNERS + - name: krew-index + description: Centralized plugin index for krew. + owners: + - https://raw.githubusercontent.com/kubernetes-sigs/krew-index/master/OWNERS - name: Cloud Provider dir: sig-cloud-provider mission_statement: > From da7d5ae22bf67360316ccc604c23257a71f1dbbc Mon Sep 17 00:00:00 2001 From: Chris Carty Date: Sat, 16 Mar 2019 12:45:47 -0400 Subject: [PATCH 05/34] added export to user and working dir examples --- contributors/guide/github-workflow.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contributors/guide/github-workflow.md b/contributors/guide/github-workflow.md index cef4e0a39..60bde11fc 100644 --- a/contributors/guide/github-workflow.md +++ b/contributors/guide/github-workflow.md @@ -22,7 +22,7 @@ Define a local working directory: # You must follow exactly this pattern, # neither `$GOPATH/src/github.com/${your github profile name/` # nor any other pattern will work. -working_dir=$GOPATH/src/k8s.io +export working_dir=$GOPATH/src/k8s.io ``` > If you already do Go development on github, the `k8s.io` directory @@ -31,7 +31,7 @@ working_dir=$GOPATH/src/k8s.io Set `user` to match your github profile name: ```sh -user={your github profile name} +export user={your github profile name} ``` Both `$working_dir` and `$user` are mentioned in the figure above. From 32b54fb1b7d0dfd4eccd83dc9f7b2f2aecf9e20e Mon Sep 17 00:00:00 2001 From: parispittman Date: Wed, 20 Mar 2019 01:41:59 -0700 Subject: [PATCH 06/34] added calendar guidelines, rm from sig-wg-life, fixed related link --- communication/calendar-guidelines.md | 48 ++++++++++++++++++++++++++++ sig-creation-procedure.md | 2 +- sig-wg-lifecycle.md | 38 +++++++++------------- 3 files changed, 64 insertions(+), 24 deletions(-) create mode 100644 communication/calendar-guidelines.md diff --git a/communication/calendar-guidelines.md b/communication/calendar-guidelines.md new file mode 100644 index 000000000..677213960 --- /dev/null +++ b/communication/calendar-guidelines.md @@ -0,0 +1,48 @@ +Project meetings are a life line of the Kubernetes project but calendaring is hard. Use this guide to help you navigate though the trickiness of calendars and learn from our fails. +PR in your favorite tip that can help others or if you have an example other than gmail. + +### "I'm a chair for a SIG or WG and need to set up a meeting": +//This may change with the addition of a gsuite but this is the current best state +*This calendar creation process will allow all of your leads to edit SIG/WG Meetings.* + +1- Use a poll service like doodle.com that will help you get a good pulse on your community and when they can meet +2- Create a new shared calendar in the meantime as 'SIG Foo Shared Calendar' + This is important as we all change jobs, email addresses, and take breaks from the project. It will allow you to transfer the ownership to the shared calendar and then the rest of your team can edit it at anytime. [example of a shared calendar with google calendars: https://support.google.com/calendar/answer/37095?hl=en] +3- Access permissions and sharing: +* Make all event details publicly accessible. Do this from an account that won't have problems with sharing and posting information publicly. This is important and you should test this first if you are not using a personal account like gmail. //TODO add a pic +* Share it with full rights ("make changes and manage sharing” on gmail) to: your SIG/WG lead mailing list and community@kubernetes.io. With great power comes great responsibility, let your other chairs know they can accidentally delete a calendar if they are trying to delete it from theirs. +* Lastly, share with view permissions only (“see all event details”) to: your SIG/WG mailing list + +4- Once you have a time cadence settled from your members, create a calendar invite with the shared calendar as the owner. //TODO add a pic +5- Name it “SIG/WG Foo [Time Cadence ex: Biweekly] Meetings” +6- Sharing: Public (note: most gmail will have a 'default visibility' setting that automatically is turned on. Default visibility is usually not public and will need to manually scroll to public) +7- Include your meeting notes, zoom information, and any other pertinent information that you want your SIG/WG to know. +8- Invite your SIG/WG mailing list and cgnt364vd8s86hr2phapfjc6uk@group.calendar.google.com (Why this weird address? This is a public calendar that will be used to populate calendars on various sites) +/end + +### "I'm a chair and the person that created the meeting is either no longer with the project or no longer at employer that holds the invite" +If you have a shared calendar with edit rights to other chairs, leads, etc., they can edit the invite and migate the situation. Also check with folks on the community@kubernetes.io team. + +If there is no shared calendar and still one owner, ask the person to transfer it to a shared calendar or you'll need to recreate one. +Best advice here is to recreate one. It won't hurt to recreate a meeting invite every few months anyway to refresh the group. + +### "I'm a contributor and want to see one of/all of the SIG calendar(s)." +* All of the SIGs and WGs have meeting agendas with detailed information at the top. You can get this information from the SIG/WG list. Join their mailing list for the most up to date calendar invites. Chairs will always invite the entire mailing list to events. +* To see all of the meetings on one calendar: https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America%2FLos_Angeles + +## Permissions Tips +#### If you are creating calendar events: +Make sure your work account doesn't have restrictions for public viewing of calendar invites you create. Test this with other contributors before sending it to mailing lists if you are unsure. This would be for both the calendar entry itself and the shared calendar if you are the chair creating it. +If this is the case, use a personal account (ex: gmail). + + +#### If you are viewing calendar events: +TODO + +## Misc Tips +Don't copy calendars if you can help it. Copying the calendar onto your calendar will prevent you from getting updates like a canceled meeting. +Always join a SIG/WG mailing list thats of interest and our main contributor list - kubernetes-dev@googlegroups.com. Accept the invite from the sender and you'll have the updates. + +If a chair is offboarding, ask them to transfer the ownership so there isn't a ghost calendar invite on your members calendar. + +//TODO - tip about timezones diff --git a/sig-creation-procedure.md b/sig-creation-procedure.md index ad2a99424..a9c04bb6c 100644 --- a/sig-creation-procedure.md +++ b/sig-creation-procedure.md @@ -1,3 +1,3 @@ ## SIG creation procedure -Moved to [sig governance](/sig-governance.md#sig-creation-procedure) +Moved to [sig-wg-lifecycle](/sig-wg-lifecycle.md) diff --git a/sig-wg-lifecycle.md b/sig-wg-lifecycle.md index 1c0d0102d..0681fb563 100644 --- a/sig-wg-lifecycle.md +++ b/sig-wg-lifecycle.md @@ -3,18 +3,17 @@ This document covers everything you need to know about the creation and retirement (“lifecycle”) of a special interest or working group within the Kubernetes project. General project governance information can be found in the [steering committee repo]. Out of scope for this document: [subproject] creation. -[Creation] -[Retirement] -# [Creation] -## Prerequisites for a SIG +## [Creation] +### Prerequisites for a SIG - [ ] Read [sig-governance.md] -- [ ] Send an email to the Steering Committee to scope the SIG and get provisional approval. +- [ ] Send an email to the Steering Committee() to scope +the SIG and get provisional approval. - [ ] Look at the checklist below for processes and tips that you will need to do while this is going on. It's best to collect this information upfront so you have a smoother process to launch - [ ] Follow the [SIG charter process] to propose and obtain approval for a charter - [ ] Announce new SIG on kubernetes-dev@googlegroups.com -## Prerequisites for a WG +### Prerequisites for a WG - [ ] Read [wg-governance.md] - [ ] Send email to [kubernetes-dev@googlegroups.com] titled "WG-Creation-Request: WG Foo" with some of the questions answered from wg-goverance.md and wait for community discourse; ask for SIG sponsorship - [ ] Do the first checklist item in the #GitHub section below and add a row to the WG section: @@ -23,7 +22,7 @@ Out of scope for this document: [subproject] creation. - [ ] Place a `/hold` on it until the members that need to review have; a contributor experience member will do this for you if they don't see one already - [ ] Send an email to the stakeholder SIG mailing lists and steering committee with the sigs.yaml pull request -## GitHub: +### GitHub: - [ ] Submit a PR that will add rows to [sigs.yaml] using the [generator doc]; this will create README files and OWNERS_ALIASES files for your new directory in `kubernetes/community` - You’ll need: - SIG Name @@ -37,7 +36,7 @@ Out of scope for this document: [subproject] creation. - [ ] Add SIG-related docs like charter.md, schedules, roadmaps, etc. to your new kubernetes/community/SIG-foo directory once the above PR is merged. - [ ] File a [Kubernetes/Org] Issue for a label; read about our [GitHub management] services -## Communicate: +### Communicate: Each one of these has a linked canonical source guideline from set up to moderation and your role and responsibilities for each. We are all responsible for enforcing our [code of conduct]. - [ ] Read [moderation.md] and understand your role in keeping our community safe - [ ] Create your mailing lists - One for your members and another for your chairs/leads @@ -48,34 +47,26 @@ Each one of these has a linked canonical source guideline from set up to moderat - [ ] Request a YouTube playlist link [youtube-guidelines.md] - [ ] Request a zoom account [zoom-guidelines.md] -## Engage: +### Engage: ...as a chair/tech lead with other chairs/tech leads - [ ] Subscribe to the kubernetes-sig-leads@googlegroups.com group - [ ] Join the #chairs-and-techleads slack channel ...with the community as part of [sig-governance.md] - [ ] Get on the schedule for [Thursday community updates]; info at the top of the agenda -- [ ] Schedule your weekly/biweekly/at least every 3 weeks update meetings [TODO - THIS MAY CHANGE ONCE WE EXPLORE GSUITE] -- Use a poll service like doodle.com that will help you get a good pulse on your community and when they can meet -- This calendar creation process will allow all of your leads to edit SIG/WG Meetings. This is important as we all change jobs, email addresses, and take breaks from the project. Shared calendars will also provide consistenacy with contributors looking for your subproject meetings, office hours, and anything else that the SIG/WGs contributors should know about. -- Create a shared calendar on your own account. [example with google calendars: https://support.google.com/calendar/answer/37095?hl=en] Note: If you are creating from a corporate account like Google, it will not be public. Do a test first and ask a friend that doesn't work at your company. - - Name it “SIG/WG Foo [Time Cadence] Meetings” - - Sharing / access settings: Make it public - - Share it with full rights ("make changes and manage sharing”) with: cgnt364vd8s86hr2phapfjc6uk@group.calendar.google.com (Why this weird address? This is a public calendar that will be used to populate calendars on various sites) - - Your SIG/WG lead email distro (see second bullet in Communicate) - - Share it with lowest level of shown details (“see all event details”): - - SIG/WG membership distro (example: kubernetes-sig-foo@) +- [ ] Schedule your weekly/biweekly/triweekly [update meetings] and create your SIG/WG shared calendar. -# [Retirement] (merging or disbandment) +## [Retirement] +(merging or disbandment) Sometimes it might be necessary to sunset a SIG or Working Group. SIGs/WGs may also merge with an existing SIG/WG if deemed appropriate, and would save project overhead in the long run. Working Groups in particular are more ephemeral than SIGs, so this process should be followed when the Working Group has accomplished it's mission. -## Prerequisites for SIG Retirement +### Prerequisites for SIG Retirement - [ ] SIG’s retirement decision follows the decision making and communication processes as outlined in their charter -## Prerequisites for WG Retirement +### Prerequisites for WG Retirement - [ ] Have completed the mission of the WG or have another reason as outlined in [wg-governance.md] -## Steps: +### Steps: - [ ] Send an email to kubernetes-dev@googlegroups.com and community@kubernetes.io alerting the community of your intentions to disband or merge. [example] - This kicks off the process for Contributor Experience’s community managers who will reach out and set an issue against `kubernetes/community` with exact next steps covered below. We can help walk through this when you get there. Most of this is covered in the same creation communication docs as above. - [ ] Archive the member and lead/chair mailing lists/[GoogleGroups] @@ -115,3 +106,4 @@ Sometimes it might be necessary to sunset a SIG or Working Group. SIGs/WGs may a [discuss-guidelines.md]: /communication/discuss-guidelines.md [Thursday community updates]: /events/community-meeting.md [example]: https://docs.google.com/document/d/1qZcAvuWBznR_oEaPWtwm7U4JNT91m8r9YOUvInU-src/edit#heading=h.jsw0l2t0ra8 +[update meetings]: /communication/calendar-guidelines.md From d7ca367ed1ba14442e107eb82df1960064399c49 Mon Sep 17 00:00:00 2001 From: parispittman Date: Wed, 20 Mar 2019 02:29:14 -0700 Subject: [PATCH 07/34] calendar clean up --- communication/calendar-guidelines.md | 1 - sig-creation-procedure.md | 2 +- sig-wg-lifecycle.md | 14 ++++++++------ 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/communication/calendar-guidelines.md b/communication/calendar-guidelines.md index 677213960..45fa80dbb 100644 --- a/communication/calendar-guidelines.md +++ b/communication/calendar-guidelines.md @@ -35,7 +35,6 @@ Best advice here is to recreate one. It won't hurt to recreate a meeting invite Make sure your work account doesn't have restrictions for public viewing of calendar invites you create. Test this with other contributors before sending it to mailing lists if you are unsure. This would be for both the calendar entry itself and the shared calendar if you are the chair creating it. If this is the case, use a personal account (ex: gmail). - #### If you are viewing calendar events: TODO diff --git a/sig-creation-procedure.md b/sig-creation-procedure.md index a9c04bb6c..e2ee859b9 100644 --- a/sig-creation-procedure.md +++ b/sig-creation-procedure.md @@ -1,3 +1,3 @@ -## SIG creation procedure +## Special Interest and Working Group creation procedure Moved to [sig-wg-lifecycle](/sig-wg-lifecycle.md) diff --git a/sig-wg-lifecycle.md b/sig-wg-lifecycle.md index 0681fb563..58dca09c5 100644 --- a/sig-wg-lifecycle.md +++ b/sig-wg-lifecycle.md @@ -1,14 +1,15 @@ -# SUMMARY: +## SUMMARY: This document covers everything you need to know about the creation and retirement (“lifecycle”) of a special interest or working group within the Kubernetes project. General project governance information can be found in the [steering committee repo]. Out of scope for this document: [subproject] creation. +[Creation] +[Retirement] -## [Creation] +## [Creation] ### Prerequisites for a SIG - [ ] Read [sig-governance.md] -- [ ] Send an email to the Steering Committee() to scope -the SIG and get provisional approval. +- [ ] Send an email to the Steering Committee to scope the SIG and get provisional approval. - [ ] Look at the checklist below for processes and tips that you will need to do while this is going on. It's best to collect this information upfront so you have a smoother process to launch - [ ] Follow the [SIG charter process] to propose and obtain approval for a charter - [ ] Announce new SIG on kubernetes-dev@googlegroups.com @@ -54,9 +55,10 @@ Each one of these has a linked canonical source guideline from set up to moderat ...with the community as part of [sig-governance.md] - [ ] Get on the schedule for [Thursday community updates]; info at the top of the agenda -- [ ] Schedule your weekly/biweekly/triweekly [update meetings] and create your SIG/WG shared calendar. +- [ ] Create a shared calendar and schedule your weekly/biweekly/triweekly weeks [update meetings] +- This calendar creation process will allow all of your leads to edit SIG/WG Meetings. This is important as we all change jobs, email addresses, and take breaks from the project. Shared calendars will also provide consistency with contributors looking for your subproject meetings, office hours, and anything else that the SIG/WGs contributors should know about. -## [Retirement] +## [Retirement] (merging or disbandment) Sometimes it might be necessary to sunset a SIG or Working Group. SIGs/WGs may also merge with an existing SIG/WG if deemed appropriate, and would save project overhead in the long run. Working Groups in particular are more ephemeral than SIGs, so this process should be followed when the Working Group has accomplished it's mission. From 122985bc00bf83d0fa4ef2b4f8cc85245eb17998 Mon Sep 17 00:00:00 2001 From: Erik Erlandson Date: Mon, 25 Feb 2019 14:59:00 -0700 Subject: [PATCH 08/34] Port the Big Data SIG to new User Group format --- OWNERS_ALIASES | 8 +-- sig-big-data/README.md | 56 --------------- sig-list.md | 7 +- sigs.yaml | 82 ++++++++++------------ {sig-big-data => ug-big-data}/OWNERS | 6 +- ug-big-data/README.md | 53 ++++++++++++++ {sig-big-data => ug-big-data}/resources.md | 0 7 files changed, 102 insertions(+), 110 deletions(-) delete mode 100644 sig-big-data/README.md rename {sig-big-data => ug-big-data}/OWNERS (56%) create mode 100644 ug-big-data/README.md rename {sig-big-data => ug-big-data}/resources.md (100%) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index a598428f0..4cd6a1262 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -30,10 +30,6 @@ aliases: - dstrebel - khenidak - feiskyer - sig-big-data-leads: - - foxish - - erikerlandson - - liyinan926 sig-cli-leads: - soltysh - seans3 @@ -158,6 +154,10 @@ aliases: - joelsmith - cji - jaybeale + ug-big-data-leads: + - foxish + - erikerlandson + - liyinan926 committee-code-of-conduct: - jdumars - parispittman diff --git a/sig-big-data/README.md b/sig-big-data/README.md deleted file mode 100644 index 762af01a4..000000000 --- a/sig-big-data/README.md +++ /dev/null @@ -1,56 +0,0 @@ - -# Big Data Special Interest Group - -Covers deploying and operating big data applications (Spark, Kafka, Hadoop, Flink, Storm, etc) on Kubernetes. We focus on integrations with big data applications and architecting the best ways to run them on Kubernetes. - -## Meetings -* Regular SIG Meeting: [Wednesdays at 17:00 UTC](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=17:00&tz=UTC). - * [Meeting notes and Agenda](https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit). - * [Meeting recordings](https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit). - -## Leadership - -### Chairs -The Chairs of the SIG run operations and processes governing the SIG. - -* Anirudh Ramanathan (**[@foxish](https://github.com/foxish)**), Rockset -* Erik Erlandson (**[@erikerlandson](https://github.com/erikerlandson)**), Red Hat -* Yinan Li (**[@liyinan926](https://github.com/liyinan926)**), Google - -## Contact -* [Slack](https://kubernetes.slack.com/messages/sig-big-data) -* [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-big-data) -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2Fbig-data) - -## GitHub Teams - -The below teams can be mentioned on issues and PRs in order to get attention from the right people. -Note that the links to display team membership will only work if you are a member of the org. - -| Team Name | Details | Description | -| --------- |:-------:| ----------- | -| @kubernetes/sig-big-data-api-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-api-reviews) | API Changes and Reviews | -| @kubernetes/sig-big-data-bugs | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-bugs) | Bug Triage and Troubleshooting | -| @kubernetes/sig-big-data-feature-requests | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-feature-requests) | Feature Requests | -| @kubernetes/sig-big-data-misc | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-misc) | General Discussion | -| @kubernetes/sig-big-data-pr-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-pr-reviews) | PR Reviews | -| @kubernetes/sig-big-data-proposals | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-proposals) | Design Proposals | -| @kubernetes/sig-big-data-test-failures | [link](https://github.com/orgs/kubernetes/teams/sig-big-data-test-failures) | Test Failures and Triage | - - -## Goals -* Design and architect ways to run big data applications effectively on Kubernetes -* Discuss ongoing implementation efforts -* Discuss resource sharing and multi-tenancy (in the context of big data applications) -* Suggest Kubernetes features where we see a need - -## Non-goals -* Endorsing any particular tool/framework - diff --git a/sig-list.md b/sig-list.md index 7cd647471..6a7c50f82 100644 --- a/sig-list.md +++ b/sig-list.md @@ -29,7 +29,6 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[Autoscaling](sig-autoscaling/README.md)|autoscaling|* [Marcin Wielgus](https://github.com/mwielgus), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-autoscaling)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-autoscaling)|* Regular SIG Meeting: [Mondays at 14:00 UTC (biweekly/triweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[AWS](sig-aws/README.md)|aws|* [Justin Santa Barbara](https://github.com/justinsb)
* [Kris Nova](https://github.com/kris-nova), VMware
* [Nishi Davidson](https://github.com/d-nishi), AWS
|* [Slack](https://kubernetes.slack.com/messages/sig-aws)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-aws)|* Regular SIG Meeting: [Fridays at 9:00 PT (Pacific Time) (biweekly 2019 start date: Jan. 11th)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Azure](sig-azure/README.md)|azure|* [Stephen Augustus](https://github.com/justaugustus), VMware
* [Dave Strebel](https://github.com/dstrebel), Microsoft
|* [Slack](https://kubernetes.slack.com/messages/sig-azure)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-azure)|* Regular SIG Meeting: [Wednesdays at 16:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
-|[Big Data](sig-big-data/README.md)|big-data|* [Anirudh Ramanathan](https://github.com/foxish), Rockset
* [Erik Erlandson](https://github.com/erikerlandson), Red Hat
* [Yinan Li](https://github.com/liyinan926), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-big-data)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-big-data)|* Regular SIG Meeting: [Wednesdays at 17:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[CLI](sig-cli/README.md)|cli|* [Maciej Szulik](https://github.com/soltysh), Red Hat
* [Sean Sullivan](https://github.com/seans3), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-cli)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cli)|* Regular SIG Meeting: [Wednesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Cloud Provider](sig-cloud-provider/README.md)|cloud-provider|* [Andrew Sy Kim](https://github.com/andrewsykim), VMware
* [Chris Hoge](https://github.com/hogepodge), OpenStack Foundation
* [Jago Macleod](https://github.com/jagosan), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-cloud-provider)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cloud-provider)|* Regular SIG Meeting: [Wednesdays at 1:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* (cloud-provider-extraction-migration) Weekly Sync removing the in-tree cloud providers led by @cheftako and @andrewsykim: [Thursdays at 13:30 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1KLsGGzNXQbsPeELCeF_q-f0h0CEGSe20xiwvcR2NlYM/edit)
|[Cluster Lifecycle](sig-cluster-lifecycle/README.md)|cluster-lifecycle|* [Robert Bailey](https://github.com/roberthbailey), Google
* [Lucas Käldström](https://github.com/luxas), Luxas Labs (occasionally contracting for Weaveworks)
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Slack](https://kubernetes.slack.com/messages/sig-cluster-lifecycle)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle)|* Regular SIG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kubeadm Office Hours: [Wednesdays at 09:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API office hours: [Wednesdays at 10:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (EMEA): [Wednesdays at 15:00 CEST (Central European Summer Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (US West Coast): [Tuesdays at 12:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API (AWS implementation) office hours: [Mondays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kops Office Hours: [Fridays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Kubespray Office Hours: [Wednesdays at 08:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
@@ -68,6 +67,12 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[Resource Management](wg-resource-management/README.md)||* [Vishnu Kannan](https://github.com/vishh), Google
* [Derek Carr](https://github.com/derekwaynecarr), Red Hat
|* [Slack](https://kubernetes.slack.com/messages/wg-resource-mgmt)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-resource-management)|* Regular WG Meeting: [Wednesdays at 11:00 PT (Pacific Time) (biweekly (On demand))](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Security Audit](wg-security-audit/README.md)||* [Aaron Small](https://github.com/aasmall), Google
* [Joel Smith](https://github.com/joelsmith), Red Hat
* [Craig Ingram](https://github.com/cji), Salesforce
* [Jay Beale](https://github.com/jaybeale), InGuardians
|* [Slack](https://kubernetes.slack.com/messages/wg-security-audit)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-security-audit)|* Regular WG Meeting: [Mondays at 13:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1RbC4SBZBlKth7IjYv_NaEpnmLGwMJ0ElpUOmsG-bdRA/edit)
+### Master User Group List + +| Name | Organizers | Contact | Meetings | +|------|------------|---------|----------| +|[Big Data](ug-big-data/README.md)|* [Anirudh Ramanathan](https://github.com/foxish), Rockset
* [Erik Erlandson](https://github.com/erikerlandson), Red Hat
* [Yinan Li](https://github.com/liyinan926), Google
|* [Slack](https://kubernetes.slack.com/messages/ug-big-data)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-ug-big-data)|* Regular User Group Meeting: [Wednesdays at 18:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
+ ### Master Committee List | Name | Label | Members | Contact | diff --git a/sigs.yaml b/sigs.yaml index 7f743a299..28627e8de 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -606,52 +606,6 @@ sigs: owners: - https://raw.githubusercontent.com/kubernetes-sigs/azuredisk-csi-driver/master/OWNERS - https://raw.githubusercontent.com/kubernetes-sigs/azurefile-csi-driver/master/OWNERS - - name: Big Data - dir: sig-big-data - mission_statement: > - Covers deploying and operating big data applications (Spark, Kafka, - Hadoop, Flink, Storm, etc) on Kubernetes. We focus on integrations with - big data applications and architecting the best ways to run them on Kubernetes. - charter_link: - label: big-data - leadership: - chairs: - - name: Anirudh Ramanathan - github: foxish - company: Rockset - - name: Erik Erlandson - github: erikerlandson - company: Red Hat - - name: Yinan Li - github: liyinan926 - company: Google - meetings: - - description: Regular SIG Meeting - day: Wednesday - time: "17:00" - tz: "UTC" - frequency: biweekly - url: https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit - archive_url: https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit - recordings_url: https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit - contact: - slack: sig-big-data - mailing_list: https://groups.google.com/forum/#!forum/kubernetes-sig-big-data - teams: - - name: sig-big-data-api-reviews - description: API Changes and Reviews - - name: sig-big-data-bugs - description: Bug Triage and Troubleshooting - - name: sig-big-data-feature-requests - description: Feature Requests - - name: sig-big-data-misc - description: General Discussion - - name: sig-big-data-pr-reviews - description: PR Reviews - - name: sig-big-data-proposals - description: Design Proposals - - name: sig-big-data-test-failures - description: Test Failures and Triage - name: CLI dir: sig-cli mission_statement: > @@ -2514,6 +2468,42 @@ workinggroups: contact: slack: wg-k8s-infra mailing_list: https://groups.google.com/forum/#!forum/kubernetes-wg-k8s-infra +usergroups: + - name: Big Data + dir: ug-big-data + mission_statement: > + Serve as a community resource for advising big data and data science related software projects + on techniques and best practices for integrating with Kubernetes. + Represents the concerns of users from big data communities to Kubernetes for the purposes of + driving new features and other enhancements, based on big data use cases. + charter_link: + label: big-data + leadership: + chairs: + - name: Anirudh Ramanathan + github: foxish + company: Rockset + - name: Erik Erlandson + github: erikerlandson + company: Red Hat + - name: Yinan Li + github: liyinan926 + company: Google + meetings: + - description: Regular User Group Meeting + day: Wednesday + time: "18:00" + tz: "UTC" + frequency: biweekly + url: https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit + archive_url: https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit + recordings_url: https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit + contact: + slack: ug-big-data + mailing_list: https://groups.google.com/forum/#!forum/kubernetes-ug-big-data + teams: + - name: ug-big-data + description: General Discussion committees: - name: Steering dir: committee-steering diff --git a/sig-big-data/OWNERS b/ug-big-data/OWNERS similarity index 56% rename from sig-big-data/OWNERS rename to ug-big-data/OWNERS index 045d7c13a..cef3c5d36 100644 --- a/sig-big-data/OWNERS +++ b/ug-big-data/OWNERS @@ -1,8 +1,8 @@ # See the OWNERS docs at https://go.k8s.io/owners reviewers: - - sig-big-data-leads + - ug-big-data-leads approvers: - - sig-big-data-leads + - ug-big-data-leads labels: - - sig/big-data + - ug/big-data diff --git a/ug-big-data/README.md b/ug-big-data/README.md new file mode 100644 index 000000000..f00b34214 --- /dev/null +++ b/ug-big-data/README.md @@ -0,0 +1,53 @@ + +# Big Data User Group + +Serve as a community resource for advising big data and data science related software projects on techniques and best practices for integrating with Kubernetes. Represents the concerns of users from big data communities to Kubernetes for the purposes of driving new features and other enhancements, based on big data use cases. + +## Meetings +* Regular User Group Meeting: [Wednesdays at 18:00 UTC](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=18:00&tz=UTC). + * [Meeting notes and Agenda](https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit). + * [Meeting recordings](https://docs.google.com/document/d/1pnF38NF6N5eM8DlK088XUW85Vms4V2uTsGZvSp8MNIA/edit). + +## Organizers + +* Anirudh Ramanathan (**[@foxish](https://github.com/foxish)**), Rockset +* Erik Erlandson (**[@erikerlandson](https://github.com/erikerlandson)**), Red Hat +* Yinan Li (**[@liyinan926](https://github.com/liyinan926)**), Google + +## Contact +* [Slack](https://kubernetes.slack.com/messages/ug-big-data) +* [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-ug-big-data) +* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/ug%2Fbig-data) + + +## GitHub Teams + +The below teams can be mentioned on issues and PRs in order to get attention from the right people. +Note that the links to display team membership will only work if you are a member of the org. + +| Team Name | Details | Description | +| --------- |:-------:| ----------- | +| @kubernetes/ug-big-data | [link](https://github.com/orgs/kubernetes/teams/ug-big-data) | General Discussion | + + + +### Goals + +- Promoting best practices for Kubernetes integrations +- Advising big data communities on Kubernetes features +- Shepherding issues and pull requests from community members +- Hosting demos and discussions of big data integrations for Kubernetes + +### Non Goals + +- Promoting or otherwise advocating for any specific big data project +- Software and tooling communities that have no intersection with data science or big data + + diff --git a/sig-big-data/resources.md b/ug-big-data/resources.md similarity index 100% rename from sig-big-data/resources.md rename to ug-big-data/resources.md From 9dd8f7006679be48790e71921c48f8dc4b0885b2 Mon Sep 17 00:00:00 2001 From: David Zhu Date: Fri, 22 Mar 2019 12:02:18 -0700 Subject: [PATCH 09/34] Update inline volume design --- .../design-proposals/storage/csi-migration.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/contributors/design-proposals/storage/csi-migration.md b/contributors/design-proposals/storage/csi-migration.md index ee6dc464c..87b75c6e9 100644 --- a/contributors/design-proposals/storage/csi-migration.md +++ b/contributors/design-proposals/storage/csi-migration.md @@ -237,8 +237,7 @@ with the in-tree plugin, the VolumeAttachment object becomes orphaned. ### In-line Volumes In-line controller calls are a special case because there is no PV. In this case -we will forward the in-tree volume source to CSI attach as-is and it will be -copied to a new field in the VolumeAttachment object +we will translate the volume source and copy it to the field VolumeAttachment.Spec.Source.VolumeAttachmentSource.InlineVolumeSource. The VolumeAttachment name must be made with the CSI Translated version of the VolumeSource in order for it to be discoverable by Detach and WaitForAttach @@ -259,12 +258,12 @@ type VolumeAttachmentSource struct { // +optional PersistentVolumeName *string `json:"persistentVolumeName,omitempty" protobuf:"bytes,1,opt,name=persistentVolumeName"` - // Allows CSI migration code to copy an inline volume - // source from a pod to the VolumeAttachment to support shimming of - // in-tree inline volumes to a CSI backend. - // This field is alpha-level and is only honored by servers that enable the CSIMigration feature. + // Translated VolumeSource from a pod to a CSIPersistentVolumeSource + // to support shimming of in-tree inline volumes to a CSI backend. + // This field is alpha-level and is only honored by servers that + // enable the CSIMigration feature. // +optional - InlineVolumeSource *v1.VolumeSource `json:"inlineVolumeSource,omitempty protobuf:"bytes,2,opt,name=inlineVolumeSource"` + InlineCSIVolumeSource *v1.CSIPersistentVolumeSource `json:"inlineCSIVolumeSource,omitempty" protobuf:"bytes,2,opt,name=inlineCSIVolumeSource"` } ``` From 30c13b79288edfba494fc494d85c00eaf6d86077 Mon Sep 17 00:00:00 2001 From: Brandon Philips Date: Wed, 20 Mar 2019 17:03:39 +0000 Subject: [PATCH 10/34] sigs.yaml: remove Jess Frazelle from Security Committee Jess helped to kick off the Security Committee over two years ago. And has decided to step down. Thanks for everything! --- OWNERS_ALIASES | 1 - committee-product-security/README.md | 1 - sig-list.md | 2 +- sigs.yaml | 2 -- 4 files changed, 1 insertion(+), 5 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index 4ec13ee3c..fdcf35a0e 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -165,7 +165,6 @@ aliases: - bradamant3 committee-product-security: - philips - - jessfraz - cjcullen - tallclair - liggitt diff --git a/committee-product-security/README.md b/committee-product-security/README.md index 3057c7ff5..3452cb2b3 100644 --- a/committee-product-security/README.md +++ b/committee-product-security/README.md @@ -14,7 +14,6 @@ The Kubernetes Product Security Committee is the body that is responsible for re ## Members * Brandon Philips (**[@philips](https://github.com/philips)**), Red Hat -* Jess Frazelle (**[@jessfraz](https://github.com/jessfraz)**) * CJ Cullen (**[@cjcullen](https://github.com/cjcullen)**), Google * Tim Allclair (**[@tallclair](https://github.com/tallclair)**), Google * Jordan Liggitt (**[@liggitt](https://github.com/liggitt)**), Google diff --git a/sig-list.md b/sig-list.md index 4ab1e56ab..f31d4cd79 100644 --- a/sig-list.md +++ b/sig-list.md @@ -73,7 +73,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) | Name | Label | Members | Contact | |------|--------|---------|---------| |[Code of Conduct](committee-code-of-conduct/README.md)|conduct|* [Jaice Singer Dumars](https://github.com/jdumars), Google
* [Paris Pittman](https://github.com/parispittman), Google
* [Carolyn Van Slyck](https://github.com/carolynvs), Microsoft
* [Eric Paris](https://github.com/eparis), Red Hat
* [Jennifer Rondeau](https://github.com/bradamant3), VMware
|* [Private Mailing List](conduct@kubernetes.io) -|[Product Security](committee-product-security/README.md)|product-security|* [Brandon Philips](https://github.com/philips), Red Hat
* [Jess Frazelle](https://github.com/jessfraz)
* [CJ Cullen](https://github.com/cjcullen), Google
* [Tim Allclair](https://github.com/tallclair), Google
* [Jordan Liggitt](https://github.com/liggitt), Google
* [Joel Smith](https://github.com/joelsmith), Red Hat
|* [Private Mailing List](security@kubernetes.io) +|[Product Security](committee-product-security/README.md)|product-security|* [Brandon Philips](https://github.com/philips), Red Hat
* [CJ Cullen](https://github.com/cjcullen), Google
* [Tim Allclair](https://github.com/tallclair), Google
* [Jordan Liggitt](https://github.com/liggitt), Google
* [Joel Smith](https://github.com/joelsmith), Red Hat
|* [Private Mailing List](security@kubernetes.io) |[Steering](committee-steering/README.md)|steering|* [Brian Grant](https://github.com/bgrant0607), Google
* [Brendan Burns](https://github.com/brendanburns), Microsoft
* [Derek Carr](https://github.com/derekwaynecarr), Red Hat
* [Davanum Srinivas](https://github.com/dims), Huawei
* [Joe Beda](https://github.com/jbeda), VMware
* [Michelle Noorali](https://github.com/michelleN), Microsoft
* [Brandon Philips](https://github.com/philips), Red Hat
* [Phillip Wittrock](https://github.com/pwittrock), Google
* [Sarah Novotny](https://github.com/sarahnovotny), Google
* [Clayton Coleman](https://github.com/smarterclayton), Red Hat
* [Aaron Crickenberger](https://github.com/spiffxp), Google
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Mailing List](https://groups.google.com/a/kubernetes.io/forum/#!forum/steering)
* [Private Mailing List](steering-private@kubernetes.io) diff --git a/sigs.yaml b/sigs.yaml index 439787e98..f7a3dc7e9 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -2650,8 +2650,6 @@ committees: - name: Brandon Philips github: philips company: Red Hat - - name: Jess Frazelle - github: jessfraz - name: CJ Cullen github: cjcullen company: Google From 6ecc986728d72054203e52f06510d82f00da1465 Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Tue, 26 Mar 2019 18:50:17 +0530 Subject: [PATCH 11/34] Add cri-api as a subproject to sig-node --- sig-node/README.md | 3 +++ sigs.yaml | 3 +++ 2 files changed, 6 insertions(+) diff --git a/sig-node/README.md b/sig-node/README.md index 68cba5ebc..9586a5379 100644 --- a/sig-node/README.md +++ b/sig-node/README.md @@ -30,6 +30,9 @@ The Chairs of the SIG run operations and processes governing the SIG. ## Subprojects The following subprojects are owned by sig-node: +- **cri-api** + - Owners: + - https://raw.githubusercontent.com/kubernetes/cri-api/master/OWNERS - **cri-o** - Owners: - https://raw.githubusercontent.com/kubernetes-sigs/cri-o/master/OWNERS diff --git a/sigs.yaml b/sigs.yaml index 0725d840c..c7541a20c 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1441,6 +1441,9 @@ sigs: - name: sig-node-test-failures description: Test Failures and Triage subprojects: + - name: cri-api + owners: + - https://raw.githubusercontent.com/kubernetes/cri-api/master/OWNERS - name: cri-o owners: - https://raw.githubusercontent.com/kubernetes-sigs/cri-o/master/OWNERS From 37331cea100eacc048f011806cf82b2d1edbf410 Mon Sep 17 00:00:00 2001 From: Ihor Dvoretskyi Date: Tue, 26 Mar 2019 19:53:47 +0200 Subject: [PATCH 12/34] Minor typo fix in moderators.md Signed-off-by: Ihor Dvoretskyi --- communication/moderators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communication/moderators.md b/communication/moderators.md index d631b3a79..1d8586510 100644 --- a/communication/moderators.md +++ b/communication/moderators.md @@ -163,7 +163,7 @@ Moderators seats: 10 | Jaice Singer DuMars | @jdumars | Americas | [PT - Pacific Time (US West Coast)](https://time.is/PT) | | Paris Pittman | @paris | Americas | [PT - Pacific Time (US West Coast)](https://time.is/PT) | | Noah Kantrowitz | @coderanger | Americas | [PT - Pacific Time (US West Coast)](https://time.is/PT) | -| Ihor Dvoretskyi | @ihor.dvoretskyi | EMEA | [EET - Easter European Time](https://time.is/EET) | +| Ihor Dvoretskyi | @ihor.dvoretskyi | EMEA | [EET - Eastern European Time](https://time.is/EET) | | Yang Li | @idealhack | APAC | [CST - China Standard Time](https://time.is/China) | From 362793966e1c36ff10d24a49cebf36e04a9e9e31 Mon Sep 17 00:00:00 2001 From: Roy Lenferink Date: Tue, 26 Mar 2019 22:51:35 +0100 Subject: [PATCH 13/34] Updated GitHub teams for localization teams --- sig-docs/README.md | 10 +++++++--- sigs.yaml | 16 ++++++++++++---- 2 files changed, 19 insertions(+), 7 deletions(-) diff --git a/sig-docs/README.md b/sig-docs/README.md index 726902041..e411a0869 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -54,9 +54,13 @@ Note that the links to display team membership will only work if you are a membe | --------- |:-------:| ----------- | | @kubernetes/sig-docs-maintainers | [link](https://github.com/orgs/kubernetes/teams/sig-docs-maintainers) | Documentation maintainers | | @kubernetes/sig-docs-pr-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-docs-pr-reviews) | Documentation PR reviews | -| @kubernetes/sig-docs-ko-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ko-owners) | Korean localization | -| @kubernetes/sig-docs-ja-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ja-owners) | Japanese localization | -| @kubernetes/sig-docs-zh-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-zh-owners) | Chinese localization | +| @kubernetes/sig-docs-en-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-en-owners) | English content (default) | +| @kubernetes/sig-docs-de-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-de-owners) | German content | +| @kubernetes/sig-docs-fr-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-fr-owners) | French content | +| @kubernetes/sig-docs-it-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-it-owners) | Italian content | +| @kubernetes/sig-docs-ja-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ja-owners) | Japanese content | +| @kubernetes/sig-docs-ko-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ko-owners) | Korean content | +| @kubernetes/sig-docs-zh-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-zh-owners) | Chinese content | ## Goals diff --git a/sigs.yaml b/sigs.yaml index b68c4bd2f..b96906660 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1110,12 +1110,20 @@ sigs: description: Documentation maintainers - name: sig-docs-pr-reviews description: Documentation PR reviews - - name: sig-docs-ko-owners - description: Korean localization + - name: sig-docs-en-owners + description: English content (default) + - name: sig-docs-de-owners + description: German content + - name: sig-docs-fr-owners + description: French content + - name: sig-docs-it-owners + description: Italian content - name: sig-docs-ja-owners - description: Japanese localization + description: Japanese content + - name: sig-docs-ko-owners + description: Korean content - name: sig-docs-zh-owners - description: Chinese localization + description: Chinese content subprojects: - name: reference-docs owners: From 84b4b9854ac2475647692e25eac3c65d88616834 Mon Sep 17 00:00:00 2001 From: farmer-hutao Date: Thu, 28 Mar 2019 10:53:00 +0800 Subject: [PATCH 14/34] add example with nodeaffinity --- .../scheduling/nodeaffinity.md | 35 ++++++++++++++++--- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/contributors/design-proposals/scheduling/nodeaffinity.md b/contributors/design-proposals/scheduling/nodeaffinity.md index ae167ce53..31fb520ae 100644 --- a/contributors/design-proposals/scheduling/nodeaffinity.md +++ b/contributors/design-proposals/scheduling/nodeaffinity.md @@ -144,12 +144,36 @@ Hopefully this won't cause too much confusion. ## Examples -**TODO: fill in this section** - -* Run this pod on a node with an Intel or AMD CPU - -* Run this pod on a node in availability zone Z +Run a pod on a node with an Intel or AMD CPU and in availability zone Z: +```yaml +apiVersion: v1 +kind: Pod +metadata: + name: pod-with-node-affinity +spec: + affinity: + nodeAffinity: + requiredDuringSchedulingIgnoredDuringExecution: + nodeSelectorTerms: + - matchExpressions: + - key: kubernetes.io/arch + operator: In + values: + - intel + - amd64 + preferredDuringSchedulingIgnoredDuringExecution: + - weight: 1 + preference: + matchExpressions: + - key: failure-domain.kubernetes.io/zone + operator: In + values: + - Z + containers: + - name: pod-with-node-affinity + image: tomcat:8 +``` ## Backward compatibility @@ -240,3 +264,4 @@ The main related issue is [#341](https://github.com/kubernetes/kubernetes/issues Issue [#367](https://github.com/kubernetes/kubernetes/issues/367) is also related. Those issues reference other related issues. + From 207487c672c140c5153665df1d206e027b009925 Mon Sep 17 00:00:00 2001 From: zacharysarah Date: Wed, 27 Mar 2019 11:26:55 -0700 Subject: [PATCH 15/34] Remove chenopis, add jaredbhatti make generate Add chenopis as emeritus lead --- OWNERS_ALIASES | 2 +- sig-docs/README.md | 8 ++++++-- sig-list.md | 2 +- sigs.yaml | 10 +++++++--- 4 files changed, 15 insertions(+), 7 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index fdcf35a0e..e169c26b3 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -53,7 +53,7 @@ aliases: - cblecker - nikhita sig-docs-leads: - - chenopis + - jaredbhatti - zacharysarah - bradamant3 sig-gcp-leads: diff --git a/sig-docs/README.md b/sig-docs/README.md index 726902041..0e1026058 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -23,9 +23,13 @@ Covers documentation, doc processes, and doc publishing for Kubernetes. ### Chairs The Chairs of the SIG run operations and processes governing the SIG. -* Andrew Chen (**[@chenopis](https://github.com/chenopis)**), Google +* Jared Bhatti (**[@jaredbhatti](https://github.com/jaredbhatti)**), Google * Zach Corleissen (**[@zacharysarah](https://github.com/zacharysarah)**), Linux Foundation -* Jennifer Rondeau (**[@bradamant3](https://github.com/bradamant3)**), VMware +* Jennifer Rondeau (**[@bradamant3](https://github.com/bradamant3)**), Stripe + +## Emeritus Leads + +* Andrew Chen (**[@chenopis](https://github.com/chenopis)**), Google ## Contact * [Slack](https://kubernetes.slack.com/messages/sig-docs) diff --git a/sig-list.md b/sig-list.md index 9e2bcc36f..580ab9f0d 100644 --- a/sig-list.md +++ b/sig-list.md @@ -34,7 +34,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[Cloud Provider](sig-cloud-provider/README.md)|cloud-provider|* [Andrew Sy Kim](https://github.com/andrewsykim), VMware
* [Chris Hoge](https://github.com/hogepodge), OpenStack Foundation
* [Jago Macleod](https://github.com/jagosan), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-cloud-provider)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cloud-provider)|* Regular SIG Meeting: [Wednesdays at 1:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* (cloud-provider-extraction-migration) Weekly Sync removing the in-tree cloud providers led by @cheftako and @mcrute: [Thursdays at 13:30 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1KLsGGzNXQbsPeELCeF_q-f0h0CEGSe20xiwvcR2NlYM/edit)
|[Cluster Lifecycle](sig-cluster-lifecycle/README.md)|cluster-lifecycle|* [Robert Bailey](https://github.com/roberthbailey), Google
* [Lucas Käldström](https://github.com/luxas), Luxas Labs (occasionally contracting for Weaveworks)
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Slack](https://kubernetes.slack.com/messages/sig-cluster-lifecycle)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle)|* Regular SIG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kubeadm Office Hours: [Wednesdays at 09:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API office hours: [Wednesdays at 10:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (EMEA): [Wednesdays at 15:00 CEST (Central European Summer Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (US West Coast): [Tuesdays at 12:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API (AWS implementation) office hours: [Mondays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kops Office Hours: [Fridays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Kubespray Office Hours: [Wednesdays at 08:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster Addons meeting: [Fridays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Contributor Experience](sig-contributor-experience/README.md)|contributor-experience|* [Elsie Phillips](https://github.com/Phillels), Red Hat
* [Paris Pittman](https://github.com/parispittman), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-contribex)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-contribex)|* Regular SIG Meeting: [Wednesdays at 9:30 PT (Pacific Time) (weekly - except fourth Wednesday every month)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* APAC SIG Meeting: [Wednesdays at 20:00 PT (Pacific Time) (monthly - fourth Wednesday every month)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* (contributors-documentation) Non-Code Contributors Meeting: [Wednesdays at 11:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1gdFWfkrapQclZ4-z4Lx2JwqKsJjXXUOVoLhBzZiZgSk/edit)
* (events) Contributor Summit strategy, content and planning: [Mondays at 9:00 PT (Pacific Time) (weekly)]()
-|[Docs](sig-docs/README.md)|docs|* [Andrew Chen](https://github.com/chenopis), Google
* [Zach Corleissen](https://github.com/zacharysarah), Linux Foundation
* [Jennifer Rondeau](https://github.com/bradamant3), VMware
|* [Slack](https://kubernetes.slack.com/messages/sig-docs)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)|* Regular SIG Meeting: [Tuesdays at 17:30 UTC (weekly - except fourth Tuesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
* APAC SIG Meeting: [Wednesdays at 02:00 UTC (monthly - fourth Wednesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
+|[Docs](sig-docs/README.md)|docs|* [Jared Bhatti](https://github.com/jaredbhatti), Google
* [Zach Corleissen](https://github.com/zacharysarah), Linux Foundation
* [Jennifer Rondeau](https://github.com/bradamant3), Stripe
|* [Slack](https://kubernetes.slack.com/messages/sig-docs)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)|* Regular SIG Meeting: [Tuesdays at 17:30 UTC (weekly - except fourth Tuesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
* APAC SIG Meeting: [Wednesdays at 02:00 UTC (monthly - fourth Wednesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
|[GCP](sig-gcp/README.md)|gcp|* [Adam Worrall](https://github.com/abgworrall), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-gcp)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-gcp)|* Regular SIG Meeting: [Thursdays at 16:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[IBMCloud](sig-ibmcloud/README.md)|ibmcloud|* [Khalid Ahmed](https://github.com/khahmed), IBM
* [Richard Theis](https://github.com/rtheis), IBM
* [Sahdev Zala](https://github.com/spzala), IBM
|* [Slack](https://kubernetes.slack.com/messages/sig-ibmcloud)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-ibmcloud)|* Regular SIG Meeting: [Wednesdays at 14:00 EST (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Instrumentation](sig-instrumentation/README.md)|instrumentation|* [Piotr Szczesniak](https://github.com/piosz), Google
* [Frederic Branczyk](https://github.com/brancz), Red Hat
|* [Slack](https://kubernetes.slack.com/messages/sig-instrumentation)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-instrumentation)|* Regular SIG Meeting: [Thursdays at 17:30 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
diff --git a/sigs.yaml b/sigs.yaml index b68c4bd2f..94d44668d 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1076,15 +1076,19 @@ sigs: label: docs leadership: chairs: - - name: Andrew Chen - github: chenopis + - name: Jared Bhatti + github: jaredbhatti company: Google - name: Zach Corleissen github: zacharysarah company: Linux Foundation - name: Jennifer Rondeau github: bradamant3 - company: VMware + company: Stripe + emeritus_leads: + - name: Andrew Chen + github: chenopis + company: Google meetings: - description: Regular SIG Meeting day: Tuesday From 3355329c0dade2d2fd98e873fe4b900f95ce7ded Mon Sep 17 00:00:00 2001 From: Bagrat Aznauryan Date: Fri, 29 Mar 2019 02:40:12 +0400 Subject: [PATCH 16/34] Fix SIG Governance link --- governance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance.md b/governance.md index 243d7a014..c56bafd1e 100644 --- a/governance.md +++ b/governance.md @@ -207,7 +207,7 @@ All contributors must sign the CNCF CLA, as described [here](CLA.md). [design principles]: /contributors/design-proposals/architecture/principles.md [scope]: https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/ [community membership]: /community-membership.md -[sig governance]: /committee-steering/sig-governance.md +[sig governance]: /committee-steering/governance/sig-governance.md [owners]: /community-membership.md#subproject-owner [sig charter process]: /committee-steering/governance/README.md [short template]: /committee-steering/governance/sig-governance-template-short.md From c91cbffdb23dea68af6ac166137ffa039b0df38e Mon Sep 17 00:00:00 2001 From: Bagrat Aznauryan Date: Fri, 29 Mar 2019 03:06:13 +0400 Subject: [PATCH 17/34] Fix a typo --- governance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance.md b/governance.md index 243d7a014..06836fc55 100644 --- a/governance.md +++ b/governance.md @@ -143,7 +143,7 @@ do not have clear deliverables or ownership of parts of the Kubernetes code base. As such they are neither good fits for SIGs or Working Groups. An example of such a topic might be continuous delivery to Kubernetes. -Though their central goal is not a a deliverable piece of work, as contributing +Though their central goal is not a deliverable piece of work, as contributing members of the community user groups are expected to work with SIGs to either identify friction or usability issues that need to be addressed, or to provide or improve documentation in their area of expertise. However From 7d8698001f1544f47038875427e76c4d7eeeace7 Mon Sep 17 00:00:00 2001 From: roc Date: Fri, 29 Mar 2019 20:09:54 +0800 Subject: [PATCH 18/34] fix url --- contributors/devel/sig-api-machinery/generating-clientset.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contributors/devel/sig-api-machinery/generating-clientset.md b/contributors/devel/sig-api-machinery/generating-clientset.md index bf12e92cb..a5619b97b 100644 --- a/contributors/devel/sig-api-machinery/generating-clientset.md +++ b/contributors/devel/sig-api-machinery/generating-clientset.md @@ -1,6 +1,6 @@ # Generation and release cycle of clientset -Client-gen is an automatic tool that generates [clientset](../design-proposals/api-machinery/client-package-structure.md#high-level-client-sets) based on API types. This doc introduces the use of client-gen, and the release cycle of the generated clientsets. +Client-gen is an automatic tool that generates [clientset](/contributors/design-proposals/api-machinery/client-package-structure.md#high-level-client-sets) based on API types. This doc introduces the use of client-gen, and the release cycle of the generated clientsets. ## Using client-gen From e2fa3a916a90c4f53def6711af9c8db51cb3d8be Mon Sep 17 00:00:00 2001 From: Bagrat Aznauryan Date: Fri, 29 Mar 2019 19:24:06 +0400 Subject: [PATCH 19/34] Fix a link to "communication" document --- committee-steering/governance/sig-governance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/committee-steering/governance/sig-governance.md b/committee-steering/governance/sig-governance.md index f48b3a5dc..2c74fc841 100644 --- a/committee-steering/governance/sig-governance.md +++ b/committee-steering/governance/sig-governance.md @@ -171,7 +171,7 @@ Issues impacting multiple subprojects in the SIG should be resolved by either: [SIG PM]: https://github.com/kubernetes/community/tree/master/sig-pm [k/enhancements]: https://github.com/kubernetes/enhancements -[forums provided]: +[forums provided]: /communication/README.md [lazy-consensus]: http://en.osswiki.info/concepts/lazy_consensus [super-majority]: https://en.wikipedia.org/wiki/Supermajority#Two-thirds_vote From 961ddb0fb09f27e21ae8cf9a36e60a06a8eb912c Mon Sep 17 00:00:00 2001 From: Bob Killen Date: Fri, 29 Mar 2019 12:14:39 -0400 Subject: [PATCH 20/34] Update calendar guidelines --- communication/calendar-guidelines.md | 151 ++++++++++++++++++++------- 1 file changed, 115 insertions(+), 36 deletions(-) diff --git a/communication/calendar-guidelines.md b/communication/calendar-guidelines.md index 45fa80dbb..e9e0b7792 100644 --- a/communication/calendar-guidelines.md +++ b/communication/calendar-guidelines.md @@ -1,47 +1,126 @@ -Project meetings are a life line of the Kubernetes project but calendaring is hard. Use this guide to help you navigate though the trickiness of calendars and learn from our fails. -PR in your favorite tip that can help others or if you have an example other than gmail. +# Calendar Guidelines -### "I'm a chair for a SIG or WG and need to set up a meeting": -//This may change with the addition of a gsuite but this is the current best state -*This calendar creation process will allow all of your leads to edit SIG/WG Meetings.* +Project meetings are a life line of the Kubernetes project. Consistent +calendaring is a challenge with many different clients, corporate policies, +time zones and various iterations of Daylight Savings Time. This guide should +help you navigate some of the common pitfalls and provide some tips & best +practices. -1- Use a poll service like doodle.com that will help you get a good pulse on your community and when they can meet -2- Create a new shared calendar in the meantime as 'SIG Foo Shared Calendar' - This is important as we all change jobs, email addresses, and take breaks from the project. It will allow you to transfer the ownership to the shared calendar and then the rest of your team can edit it at anytime. [example of a shared calendar with google calendars: https://support.google.com/calendar/answer/37095?hl=en] -3- Access permissions and sharing: -* Make all event details publicly accessible. Do this from an account that won't have problems with sharing and posting information publicly. This is important and you should test this first if you are not using a personal account like gmail. //TODO add a pic -* Share it with full rights ("make changes and manage sharing” on gmail) to: your SIG/WG lead mailing list and community@kubernetes.io. With great power comes great responsibility, let your other chairs know they can accidentally delete a calendar if they are trying to delete it from theirs. -* Lastly, share with view permissions only (“see all event details”) to: your SIG/WG mailing list +Please feel free to PR in your favorite tips and tricks that may help others. -4- Once you have a time cadence settled from your members, create a calendar invite with the shared calendar as the owner. //TODO add a pic -5- Name it “SIG/WG Foo [Time Cadence ex: Biweekly] Meetings” -6- Sharing: Public (note: most gmail will have a 'default visibility' setting that automatically is turned on. Default visibility is usually not public and will need to manually scroll to public) -7- Include your meeting notes, zoom information, and any other pertinent information that you want your SIG/WG to know. -8- Invite your SIG/WG mailing list and cgnt364vd8s86hr2phapfjc6uk@group.calendar.google.com (Why this weird address? This is a public calendar that will be used to populate calendars on various sites) -/end +- [Establishing a New Meeting](#establishing-a-new-meeting) + - [Testing Permissions](#testing-permissions) +- [Transferring Ownership](#transferring-ownership) +- [Tips](#tips) + - [Viewing Kubernetes Project Calendars](#viewing-kubernetes-project-calendars) + - [Adding Events to Your own Calendar](#adding-events-to-your-own-calendar) +- [Troubleshooting](#troubleshooting) + - [Permissions Impacted After Changing Positions or Role](#permissions-impacted-after-changing-positions-or-role) -### "I'm a chair and the person that created the meeting is either no longer with the project or no longer at employer that holds the invite" -If you have a shared calendar with edit rights to other chairs, leads, etc., they can edit the invite and migate the situation. Also check with folks on the community@kubernetes.io team. -If there is no shared calendar and still one owner, ask the person to transfer it to a shared calendar or you'll need to recreate one. -Best advice here is to recreate one. It won't hurt to recreate a meeting invite every few months anyway to refresh the group. +## Establishing a New Meeting -### "I'm a contributor and want to see one of/all of the SIG calendar(s)." -* All of the SIGs and WGs have meeting agendas with detailed information at the top. You can get this information from the SIG/WG list. Join their mailing list for the most up to date calendar invites. Chairs will always invite the entire mailing list to events. -* To see all of the meetings on one calendar: https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America%2FLos_Angeles +_"I'm a chair for a SIG or WG and need to set up a meeting."_ -## Permissions Tips -#### If you are creating calendar events: -Make sure your work account doesn't have restrictions for public viewing of calendar invites you create. Test this with other contributors before sending it to mailing lists if you are unsure. This would be for both the calendar entry itself and the shared calendar if you are the chair creating it. -If this is the case, use a personal account (ex: gmail). +This procedure will create a calendar that allows for you and all your SIG/WG +Chairs or Tech Leads to edit and manage the meetings. -#### If you are viewing calendar events: -TODO +**NOTE:** As of March 2019, this is the current best practice. However with the +addition of [gsuite], this practice may change soon. -## Misc Tips -Don't copy calendars if you can help it. Copying the calendar onto your calendar will prevent you from getting updates like a canceled meeting. -Always join a SIG/WG mailing list thats of interest and our main contributor list - kubernetes-dev@googlegroups.com. Accept the invite from the sender and you'll have the updates. +1. Use a poll service such as [doodle] that will help you get a good pulse on + your community and when they can meet. +2. Create a [new shared calendar] titled "[SIG|WG] Foo Shared Calendar" from + a gmail/google account that will not have problems sharing or posting + information publicly. This may mean using a personal gmail account if your + corporate policies restrict sharing. See [Testing Permissions] to validate + you can share your calendar. + - Creating a shared calendar is essential. If you change jobs, email + addresses, or take a break from the project it allows for a smooth transfer + of ownership. +3. [Configure access permissions and sharing:] + - Make all event details publicly accessible. + - Share it with full rights ("make changes and manage sharing”) to your SIG/WG + lead mailing list and community@kubernetes.io. + - Let your other chairs and leads know they can accidentally delete a calendar + while trying to delete it from theirs. + - Share with view permissions only (“see all event details”) to your SIG/WG + mailing list. +4. Once you have a time cadence settled from your members, create a calendar + invite with the shared calendar as the owner. Configure it with the + following settings: + - Name it “[SIG|WG] Foo [Time Cadence ex: Biweekly] Meetings”. + - Set sharing to public. **NOTE:** most gmail accounts will have a "default + visibility" setting enabled. Default visibility is usually "private" and + will need to be set to "public". + - In the calendar invite body - include your meeting notes, zoom information, + and any other pertinent information that you want your group to know. + - Invite your SIG/WG mailing list and the Kubernetes Community Public + Calendar address: `cgnt364vd8s86hr2phapfjc6uk@group.calendar.google.com` -If a chair is offboarding, ask them to transfer the ownership so there isn't a ghost calendar invite on your members calendar. -//TODO - tip about timezones +### Testing Permissions + +Make sure your work account doesn't have restrictions for public viewing of +calendar invites you create. If you are unsure, test this with other +contributors before sending it to mailing lists. This is applicable for both the +calendar entry itself and the shared calendar if you are the chair creating it. + + +## Transferring Ownership + +If a chair is offboarding, ensure that shared calendar permissions are +configured. Once the calendar has been migrated, send out a new invite to ensure +there are no possible ghost-entries in member's calendars. + +## Tips + +### Viewing Kubernetes Project Calendars + + _"I'm a contributor and want to see one of/all of the SIG calendar(s)."_ + +Public Kubernetes Events can be seen on the [Public Community Calendar]. + +All of the SIGs and WGs have meeting agendas with detailed information at the +top. You can get this information from the [SIG/WG list]. Join their mailing +list for the most up to date calendar invites. Chairs will always invite the +entire mailing list to their events. + + +### Adding Events to Your own Calendar + +Don't copy calendars if you can help it. Copying the calendar onto your calendar +will prevent you from getting updates like a canceled meeting. Join the main +[contributor mailing list] and any [SIG/WG list] that is of interest. + +Accept the invite from the sender and you'll have the updates. + + +## Troubleshooting + +### Permissions Impacted After Changing Positions or Role + +_"I'm a chair and the person that created the meeting is either no longer with +the project or no longer at an employer that holds the invite"_ + +If the calendar was created as a shared calendar with edit rights granted to +other chairs and leads they should be able to edit the invite and migrate +ownership without issue. If you do not have permissions, check first by sending +an email to community@kubernetes.io. Permissions may have been granted that team +and they will be able to facilitate the change in ownership. + +If there is no shared calendar and still one owner, ask the person to transfer +it to a shared calendar or you'll need to create a new one. In these cases it +often best to just create a new one to avoid any possible issues with the +previous calendar. It doesn't hurt to recreate a meeting invite every few months +to refresh invites sent to the group. + + +[gsuite]: https://github.com/kubernetes/community/issues/3362 +[doodle]: https://doodle.com +[testing permissions]: #testing-permissions +[new shared calendar]: https://support.google.com/calendar/answer/37095?hl=en +[configure access permissions and sharing:]: https://support.google.com/calendar/answer/37082?hl=en +[SIG/WG list]: /sig-list.md +[Public Community Calendar]: https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America%2FLos_Angeles +[contributor mailing list]: https://groups.google.com/forum/#!forum/kubernetes-dev \ No newline at end of file From 702d10d7a4b4e203edd26246195d185dff78dbc6 Mon Sep 17 00:00:00 2001 From: Lance Bragstad Date: Wed, 27 Mar 2019 19:57:18 +0000 Subject: [PATCH 21/34] Update links in api conventions document As I was reading through api-conventions.md, I noticed a couple of broken links. This commit updates those links to resolve to their previously linked content. --- contributors/devel/sig-architecture/api-conventions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contributors/devel/sig-architecture/api-conventions.md b/contributors/devel/sig-architecture/api-conventions.md index 24ae0ebfd..be47d4702 100644 --- a/contributors/devel/sig-architecture/api-conventions.md +++ b/contributors/devel/sig-architecture/api-conventions.md @@ -379,7 +379,7 @@ Some resources in the v1 API contain fields called **`phase`**, and associated `message`, `reason`, and other status fields. The pattern of using `phase` is deprecated. Newer API types should use conditions instead. Phase was essentially a state-machine enumeration field, that contradicted [system-design -principles](../design-proposals/architecture/principles.md#control-logic) and +principles](../../design-proposals/architecture/principles.md#control-logic) and hampered evolution, since [adding new enum values breaks backward compatibility](api_changes.md). Rather than encouraging clients to infer implicit properties from phases, we prefer to explicitly expose the individual @@ -404,7 +404,7 @@ only provided with reasonable effort, and is not guaranteed to not be lost. Status information that may be large (especially proportional in size to collections of other resources, such as lists of references to other objects -- see below) and/or rapidly changing, such as -[resource usage](../design-proposals/scheduling/resources.md#usage-data), should be put into separate +[resource usage](../../design-proposals/scheduling/resources.md#usage-data), should be put into separate objects, with possibly a reference from the original object. This helps to ensure that GETs and watch remain reasonably efficient for the majority of clients, which may not need that data. From 9ee07d14559a8a4f03b8dd04619f9e48173ddf39 Mon Sep 17 00:00:00 2001 From: Bob Killen Date: Mon, 1 Apr 2019 10:17:39 -0400 Subject: [PATCH 22/34] Correct github handle for Brendan Burns in SC list. --- OWNERS_ALIASES | 2 +- committee-steering/README.md | 2 +- sig-list.md | 2 +- sigs.yaml | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index e169c26b3..41a94e120 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -171,7 +171,7 @@ aliases: - joelsmith committee-steering: - bgrant0607 - - brendanburns + - brendandburns - derekwaynecarr - dims - jbeda diff --git a/committee-steering/README.md b/committee-steering/README.md index 9bb0214a5..d06523507 100644 --- a/committee-steering/README.md +++ b/committee-steering/README.md @@ -19,7 +19,7 @@ The [charter](https://git.k8s.io/steering/charter.md) defines the scope and gove ## Members * Brian Grant (**[@bgrant0607](https://github.com/bgrant0607)**), Google -* Brendan Burns (**[@brendanburns](https://github.com/brendanburns)**), Microsoft +* Brendan Burns (**[@brendandburns](https://github.com/brendandburns)**), Microsoft * Derek Carr (**[@derekwaynecarr](https://github.com/derekwaynecarr)**), Red Hat * Davanum Srinivas (**[@dims](https://github.com/dims)**), Huawei * Joe Beda (**[@jbeda](https://github.com/jbeda)**), VMware diff --git a/sig-list.md b/sig-list.md index 580ab9f0d..a29381d95 100644 --- a/sig-list.md +++ b/sig-list.md @@ -74,7 +74,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |------|--------|---------|---------| |[Code of Conduct](committee-code-of-conduct/README.md)|conduct|* [Jaice Singer Dumars](https://github.com/jdumars), Google
* [Paris Pittman](https://github.com/parispittman), Google
* [Carolyn Van Slyck](https://github.com/carolynvs), Microsoft
* [Eric Paris](https://github.com/eparis), Red Hat
* [Jennifer Rondeau](https://github.com/bradamant3), VMware
|* [Private Mailing List](conduct@kubernetes.io) |[Product Security](committee-product-security/README.md)|product-security|* [Brandon Philips](https://github.com/philips), Red Hat
* [CJ Cullen](https://github.com/cjcullen), Google
* [Tim Allclair](https://github.com/tallclair), Google
* [Jordan Liggitt](https://github.com/liggitt), Google
* [Joel Smith](https://github.com/joelsmith), Red Hat
|* [Private Mailing List](security@kubernetes.io) -|[Steering](committee-steering/README.md)|steering|* [Brian Grant](https://github.com/bgrant0607), Google
* [Brendan Burns](https://github.com/brendanburns), Microsoft
* [Derek Carr](https://github.com/derekwaynecarr), Red Hat
* [Davanum Srinivas](https://github.com/dims), Huawei
* [Joe Beda](https://github.com/jbeda), VMware
* [Michelle Noorali](https://github.com/michelleN), Microsoft
* [Brandon Philips](https://github.com/philips), Red Hat
* [Phillip Wittrock](https://github.com/pwittrock), Google
* [Sarah Novotny](https://github.com/sarahnovotny), Google
* [Clayton Coleman](https://github.com/smarterclayton), Red Hat
* [Aaron Crickenberger](https://github.com/spiffxp), Google
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Mailing List](https://groups.google.com/a/kubernetes.io/forum/#!forum/steering)
* [Private Mailing List](steering-private@kubernetes.io) +|[Steering](committee-steering/README.md)|steering|* [Brian Grant](https://github.com/bgrant0607), Google
* [Brendan Burns](https://github.com/brendandburns), Microsoft
* [Derek Carr](https://github.com/derekwaynecarr), Red Hat
* [Davanum Srinivas](https://github.com/dims), Huawei
* [Joe Beda](https://github.com/jbeda), VMware
* [Michelle Noorali](https://github.com/michelleN), Microsoft
* [Brandon Philips](https://github.com/philips), Red Hat
* [Phillip Wittrock](https://github.com/pwittrock), Google
* [Sarah Novotny](https://github.com/sarahnovotny), Google
* [Clayton Coleman](https://github.com/smarterclayton), Red Hat
* [Aaron Crickenberger](https://github.com/spiffxp), Google
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Mailing List](https://groups.google.com/a/kubernetes.io/forum/#!forum/steering)
* [Private Mailing List](steering-private@kubernetes.io) diff --git a/sigs.yaml b/sigs.yaml index cbeefd9d6..47d9df41b 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1076,7 +1076,7 @@ sigs: label: docs leadership: chairs: - - name: Jared Bhatti + - name: Jared Bhatti github: jaredbhatti company: Google - name: Zach Corleissen @@ -2564,7 +2564,7 @@ committees: github: bgrant0607 company: Google - name: Brendan Burns - github: brendanburns + github: brendandburns company: Microsoft - name: Derek Carr github: derekwaynecarr From a9adf07e62453dc57a73708b2b5944a335e54063 Mon Sep 17 00:00:00 2001 From: Nishi Davidson Date: Tue, 2 Apr 2019 21:34:02 -0700 Subject: [PATCH 23/34] Add two new subprojects to SIG AWS Autogenerate docs --- sig-aws/README.md | 6 ++++++ sigs.yaml | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/sig-aws/README.md b/sig-aws/README.md index 17c07c25e..0516015f6 100644 --- a/sig-aws/README.md +++ b/sig-aws/README.md @@ -48,6 +48,12 @@ The following subprojects are owned by sig-aws: - **aws-ebs-csi-driver** - Owners: - https://raw.githubusercontent.com/kubernetes-sigs/aws-ebs-csi-driver/master/OWNERS +- **aws-efs-csi-driver** + - Owners: + - https://raw.githubusercontent.com/kubernetes-sigs/aws-efs-csi-driver/master/OWNERS +- **aws-fsx-csi-driver** + - Owners: + - https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/OWNERS ## GitHub Teams diff --git a/sigs.yaml b/sigs.yaml index f92bcf5a9..42df01569 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -563,6 +563,12 @@ sigs: - name: aws-ebs-csi-driver owners: - https://raw.githubusercontent.com/kubernetes-sigs/aws-ebs-csi-driver/master/OWNERS + - name: aws-efs-csi-driver + owners: + - https://raw.githubusercontent.com/kubernetes-sigs/aws-efs-csi-driver/master/OWNERS + - name: aws-fsx-csi-driver + owners: + - https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/OWNERS - name: Azure dir: sig-azure mission_statement: > From ba69a7d88c3b1a7a6817f6ebc77271a00c7c45ae Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Fri, 29 Mar 2019 20:40:52 +0530 Subject: [PATCH 24/34] Add cli-experimental subproject to sig-cli --- sig-cli/README.md | 3 +++ sigs.yaml | 3 +++ 2 files changed, 6 insertions(+) diff --git a/sig-cli/README.md b/sig-cli/README.md index f3821b03a..2b3c54407 100644 --- a/sig-cli/README.md +++ b/sig-cli/README.md @@ -66,6 +66,9 @@ The following subprojects are owned by sig-cli: - Description: Centralized plugin index for krew. - Owners: - https://raw.githubusercontent.com/kubernetes-sigs/krew-index/master/OWNERS +- **cli-experimental** + - Owners: + - https://raw.githubusercontent.com/kubernetes-sigs/cli-experimental/master/OWNERS ## GitHub Teams diff --git a/sigs.yaml b/sigs.yaml index f92bcf5a9..a22f97194 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -740,6 +740,9 @@ sigs: description: Centralized plugin index for krew. owners: - https://raw.githubusercontent.com/kubernetes-sigs/krew-index/master/OWNERS + - name: cli-experimental + owners: + - https://raw.githubusercontent.com/kubernetes-sigs/cli-experimental/master/OWNERS - name: Cloud Provider dir: sig-cloud-provider mission_statement: > From 4feccf76ff0b8bd3e7326a586e2e810748dc65a7 Mon Sep 17 00:00:00 2001 From: Mucahit Kurt Date: Wed, 3 Apr 2019 09:00:18 +0300 Subject: [PATCH 25/34] fix broken link of sig storage contributor guide Signed-off-by: Mucahit Kurt --- sig-storage/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sig-storage/README.md b/sig-storage/README.md index f3f513941..7d54830ab 100644 --- a/sig-storage/README.md +++ b/sig-storage/README.md @@ -103,7 +103,7 @@ We hold a public meeting every two weeks, on Thursdays at 9 AM (PT). * Recordings of past meetings: https://www.youtube.com/playlist?list=PLb1_clREIGYVaqvKaUsVyXxjfcSQDBnmB ### Contributing -Interested in contributing to storage features in Kubernetes? [Please read our guide for new contributors](https://github.com/kubernetes/community/blob/master/sig-storage/CONTRIBUTING.md) +Interested in contributing to storage features in Kubernetes? [Please read our guide for new contributors](/sig-storage/contributing.md) ### Links * Public Slack Channel: https://kubernetes.slack.com/messages/sig-storage/details/ From 48572a00590b2881d647f2da9f412898e08b8dc0 Mon Sep 17 00:00:00 2001 From: dsatya Date: Wed, 3 Apr 2019 21:51:55 +0530 Subject: [PATCH 26/34] Add missing link to SIG lifecycle --- governance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance.md b/governance.md index fb92127e0..a2f313328 100644 --- a/governance.md +++ b/governance.md @@ -201,7 +201,7 @@ All contributors must sign the CNCF CLA, as described [here](CLA.md). [positive experiences]: https://www.cncf.io/blog/2016/12/14/diversity-scholarship-series-one-software-engineers-unexpected-cloudnativecon-kubecon-experience [sigs.yaml]: /sigs.yaml -[SIG Lifecycle]: /sig-wg-lifecycle +[SIG Lifecycle]: /sig-wg-lifecycle.md [We have them!]: /values.md [Kubernetes code of conduct]: /code-of-conduct.md [design principles]: /contributors/design-proposals/architecture/principles.md From 4ddb218a9c2f3490e91f191ff0e4942f86087757 Mon Sep 17 00:00:00 2001 From: "Lubomir I. Ivanov" Date: Thu, 4 Apr 2019 18:49:24 +0300 Subject: [PATCH 27/34] sig-cluster-lifecycle: update the list of chairs --- OWNERS_ALIASES | 2 +- sig-cluster-lifecycle/README.md | 6 +++++- sig-list.md | 2 +- sigs.yaml | 8 ++++++-- 4 files changed, 13 insertions(+), 5 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index 41a94e120..3787a0a14 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -44,7 +44,7 @@ aliases: - hogepodge - jagosan sig-cluster-lifecycle-leads: - - roberthbailey + - justinsb - luxas - timothysc sig-contributor-experience-leads: diff --git a/sig-cluster-lifecycle/README.md b/sig-cluster-lifecycle/README.md index 0a7513f61..0dfb78fcc 100644 --- a/sig-cluster-lifecycle/README.md +++ b/sig-cluster-lifecycle/README.md @@ -41,10 +41,14 @@ The Cluster Lifecycle SIG examines how we should change Kubernetes to make it ea ### Chairs The Chairs of the SIG run operations and processes governing the SIG. -* Robert Bailey (**[@roberthbailey](https://github.com/roberthbailey)**), Google +* Justin Santa Barbara (**[@justinsb](https://github.com/justinsb)**), Google * Lucas Käldström (**[@luxas](https://github.com/luxas)**), Luxas Labs (occasionally contracting for Weaveworks) * Timothy St. Clair (**[@timothysc](https://github.com/timothysc)**), VMware +## Emeritus Leads + +* Robert Bailey (**[@roberthbailey](https://github.com/roberthbailey)**), Google + ## Contact * [Slack](https://kubernetes.slack.com/messages/sig-cluster-lifecycle) * [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle) diff --git a/sig-list.md b/sig-list.md index a29381d95..d90c538a4 100644 --- a/sig-list.md +++ b/sig-list.md @@ -32,7 +32,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[Big Data](sig-big-data/README.md)|big-data|* [Anirudh Ramanathan](https://github.com/foxish), Rockset
* [Erik Erlandson](https://github.com/erikerlandson), Red Hat
* [Yinan Li](https://github.com/liyinan926), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-big-data)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-big-data)|* Regular SIG Meeting: [Wednesdays at 17:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[CLI](sig-cli/README.md)|cli|* [Maciej Szulik](https://github.com/soltysh), Red Hat
* [Sean Sullivan](https://github.com/seans3), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-cli)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cli)|* Regular SIG Meeting: [Wednesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Cloud Provider](sig-cloud-provider/README.md)|cloud-provider|* [Andrew Sy Kim](https://github.com/andrewsykim), VMware
* [Chris Hoge](https://github.com/hogepodge), OpenStack Foundation
* [Jago Macleod](https://github.com/jagosan), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-cloud-provider)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cloud-provider)|* Regular SIG Meeting: [Wednesdays at 1:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* (cloud-provider-extraction-migration) Weekly Sync removing the in-tree cloud providers led by @cheftako and @mcrute: [Thursdays at 13:30 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1KLsGGzNXQbsPeELCeF_q-f0h0CEGSe20xiwvcR2NlYM/edit)
-|[Cluster Lifecycle](sig-cluster-lifecycle/README.md)|cluster-lifecycle|* [Robert Bailey](https://github.com/roberthbailey), Google
* [Lucas Käldström](https://github.com/luxas), Luxas Labs (occasionally contracting for Weaveworks)
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Slack](https://kubernetes.slack.com/messages/sig-cluster-lifecycle)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle)|* Regular SIG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kubeadm Office Hours: [Wednesdays at 09:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API office hours: [Wednesdays at 10:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (EMEA): [Wednesdays at 15:00 CEST (Central European Summer Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (US West Coast): [Tuesdays at 12:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API (AWS implementation) office hours: [Mondays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kops Office Hours: [Fridays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Kubespray Office Hours: [Wednesdays at 08:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster Addons meeting: [Fridays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
+|[Cluster Lifecycle](sig-cluster-lifecycle/README.md)|cluster-lifecycle|* [Justin Santa Barbara](https://github.com/justinsb), Google
* [Lucas Käldström](https://github.com/luxas), Luxas Labs (occasionally contracting for Weaveworks)
* [Timothy St. Clair](https://github.com/timothysc), VMware
|* [Slack](https://kubernetes.slack.com/messages/sig-cluster-lifecycle)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle)|* Regular SIG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kubeadm Office Hours: [Wednesdays at 09:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API office hours: [Wednesdays at 10:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (EMEA): [Wednesdays at 15:00 CEST (Central European Summer Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API Provider Implementers' office hours (US West Coast): [Tuesdays at 12:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster API (AWS implementation) office hours: [Mondays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* kops Office Hours: [Fridays at 09:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Kubespray Office Hours: [Wednesdays at 08:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Cluster Addons meeting: [Fridays at 10:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Contributor Experience](sig-contributor-experience/README.md)|contributor-experience|* [Elsie Phillips](https://github.com/Phillels), Red Hat
* [Paris Pittman](https://github.com/parispittman), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-contribex)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-contribex)|* Regular SIG Meeting: [Wednesdays at 9:30 PT (Pacific Time) (weekly - except fourth Wednesday every month)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* APAC SIG Meeting: [Wednesdays at 20:00 PT (Pacific Time) (monthly - fourth Wednesday every month)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* (contributors-documentation) Non-Code Contributors Meeting: [Wednesdays at 11:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1gdFWfkrapQclZ4-z4Lx2JwqKsJjXXUOVoLhBzZiZgSk/edit)
* (events) Contributor Summit strategy, content and planning: [Mondays at 9:00 PT (Pacific Time) (weekly)]()
|[Docs](sig-docs/README.md)|docs|* [Jared Bhatti](https://github.com/jaredbhatti), Google
* [Zach Corleissen](https://github.com/zacharysarah), Linux Foundation
* [Jennifer Rondeau](https://github.com/bradamant3), Stripe
|* [Slack](https://kubernetes.slack.com/messages/sig-docs)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)|* Regular SIG Meeting: [Tuesdays at 17:30 UTC (weekly - except fourth Tuesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
* APAC SIG Meeting: [Wednesdays at 02:00 UTC (monthly - fourth Wednesday every month)](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit)
|[GCP](sig-gcp/README.md)|gcp|* [Adam Worrall](https://github.com/abgworrall), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-gcp)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-gcp)|* Regular SIG Meeting: [Thursdays at 16:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
diff --git a/sigs.yaml b/sigs.yaml index 59e52b35d..660512a98 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -838,8 +838,8 @@ sigs: label: cluster-lifecycle leadership: chairs: - - name: Robert Bailey - github: roberthbailey + - name: Justin Santa Barbara + github: justinsb company: Google - name: Lucas Käldström github: luxas @@ -847,6 +847,10 @@ sigs: - name: Timothy St. Clair github: timothysc company: VMware + emeritus_leads: + - name: Robert Bailey + github: roberthbailey + company: Google meetings: - description: Regular SIG Meeting day: Tuesday From bbe25ce278e71fa98fbcda25d9e17bc6f57c1ef0 Mon Sep 17 00:00:00 2001 From: sai-adarsh Date: Wed, 3 Apr 2019 02:54:14 +0530 Subject: [PATCH 28/34] Fixes Contribtuors PR doc --- contributors/devel/development.md | 97 +++++++++++++++++++++++++-- contributors/guide/github-workflow.md | 89 +----------------------- 2 files changed, 92 insertions(+), 94 deletions(-) diff --git a/contributors/devel/development.md b/contributors/devel/development.md index 0c2fa44b3..c2bee309d 100644 --- a/contributors/devel/development.md +++ b/contributors/devel/development.md @@ -120,12 +120,6 @@ tools]. Kubernetes build system requires `rsync` command present in the development platform. -### etcd - -Kubernetes maintains state in [`etcd`][etcd-latest], a distributed key store. - -Please [install it locally][etcd-install] to run local integration tests. - ### Go Kubernetes is written in [Go](http://golang.org). If you don't have a Go @@ -160,6 +154,97 @@ images. This requires pushing the [e2e][e2e-image] and [test][test-image] images that are `FROM` the desired Go version. - The cross tag `KUBE_BUILD_IMAGE_CROSS_TAG` in [build/common.sh]. +### Quick Start + +The following section is a quick start on how to build Kubernetes locally, for more detailed information you can see [kubernetes/build](https://git.k8s.io/kubernetes/build/README.md). +The best way to validate your current setup is to build a small part of Kubernetes. This way you can address issues without waiting for the full build to complete. To build a specific part of Kubernetes use the `WHAT` environment variable to let the build scripts know you want to build only a certain package/executable. + +```sh +make WHAT=cmd/{$package_you_want} +``` + +*Note:* This applies to all top level folders under kubernetes/cmd. + +So for the cli, you can run: + +```sh +make WHAT=cmd/kubectl +``` + +If everything checks out you will have an executable in the `_output/bin` directory to play around with. + +*Note:* If you are using `CDPATH`, you must either start it with a leading colon, or unset the variable. The make rules and scripts to build require the current directory to come first on the CD search path in order to properly navigate between directories. + +```sh +cd $working_dir/kubernetes +make +``` + +To remove the limit on the number of errors the Go compiler reports (default +limit is 10 errors): +```sh +make GOGCFLAGS="-e" +``` + +To build with optimizations disabled (enables use of source debug tools): + +```sh +make GOGCFLAGS="-N -l" +``` + +To build binaries for all platforms: + +```sh +make cross +``` + +#### Install etcd + +```sh +cd $working_dir/kubernetes + +# Installs in ./third_party/etcd +hack/install-etcd.sh + +# Add to PATH +echo export PATH="\$PATH:$working_dir/kubernetes/third_party/etcd" >> ~/.profile +``` + +#### Test + +```sh +cd $working_dir/kubernetes + +# Run all the presubmission verification. Then, run a specific update script (hack/update-*.sh) +# for each failed verification. For example: +# hack/update-gofmt.sh (to make sure all files are correctly formatted, usually needed when you add new files) +# hack/update-bazel.sh (to update bazel build related files, usually needed when you add or remove imports) +make verify + +# Alternatively, run all update scripts to avoid fixing verification failures one by one. +make update + +# Run every unit test +make test + +# Run package tests verbosely +make test WHAT=./pkg/api/helper GOFLAGS=-v + +# Run integration tests, requires etcd +# For more info, visit https://git.k8s.io/community/contributors/devel/sig-testing/testing.md#integration-tests +make test-integration + +# Run e2e tests by building test binaries, turn up a test cluster, run all tests, and tear the cluster down +# Equivalent to: go run hack/e2e.go -- -v --build --up --test --down +# Note: running all e2e tests takes a LONG time! To run specific e2e tests, visit: +# ./e2e-tests.md#building-kubernetes-and-running-the-tests +make test-e2e +``` + +See the [testing guide](./sig-testing/testing.md) and [end-to-end tests](./sig-testing/e2e-tests.md) +for additional information and scenarios. + +Run `make help` for additional information on these make targets. #### Dependency management diff --git a/contributors/guide/github-workflow.md b/contributors/guide/github-workflow.md index 60bde11fc..01ae6e804 100644 --- a/contributors/guide/github-workflow.md +++ b/contributors/guide/github-workflow.md @@ -74,95 +74,8 @@ git checkout -b myfeature Then edit code on the `myfeature` branch. #### Build -The following section is a quick start on how to build Kubernetes locally, for more detailed information you can see [kubernetes/build](https://git.k8s.io/kubernetes/build/README.md). -The best way to validate your current setup is to build a small part of Kubernetes. This way you can address issues without waiting for the full build to complete. To build a specific part of Kubernetes use the `WHAT` environment variable to let the build scripts know you want to build only a certain package/executable. -```sh -make WHAT=cmd/{$package_you_want} -``` - -*Note:* This applies to all top level folders under kubernetes/cmd. - -So for the cli, you can run: - -```sh -make WHAT=cmd/kubectl -``` - -If everything checks out you will have an executable in the `_output/bin` directory to play around with. - -*Note:* If you are using `CDPATH`, you must either start it with a leading colon, or unset the variable. The make rules and scripts to build require the current directory to come first on the CD search path in order to properly navigate between directories. - -```sh -cd $working_dir/kubernetes -make -``` - -To remove the limit on the number of errors the Go compiler reports (default -limit is 10 errors): -```sh -make GOGCFLAGS="-e" -``` - -To build with optimizations disabled (enables use of source debug tools): - -```sh -make GOGCFLAGS="-N -l" -``` - -To build binaries for all platforms: - -```sh -make cross -``` - -#### Install etcd - -```sh -cd $working_dir/kubernetes - -# Installs in ./third_party/etcd -hack/install-etcd.sh - -# Add to PATH -echo export PATH="\$PATH:$working_dir/kubernetes/third_party/etcd" >> ~/.profile -``` - -#### Test - -```sh -cd $working_dir/kubernetes - -# Run all the presubmission verification. Then, run a specific update script (hack/update-*.sh) -# for each failed verification. For example: -# hack/update-gofmt.sh (to make sure all files are correctly formatted, usually needed when you add new files) -# hack/update-bazel.sh (to update bazel build related files, usually needed when you add or remove imports) -make verify - -# Alternatively, run all update scripts to avoid fixing verification failures one by one. -make update - -# Run every unit test -make test - -# Run package tests verbosely -make test WHAT=./pkg/api/helper GOFLAGS=-v - -# Run integration tests, requires etcd -# For more info, visit https://git.k8s.io/community/contributors/devel/sig-testing/testing.md#integration-tests -make test-integration - -# Run e2e tests by building test binaries, turn up a test cluster, run all tests, and tear the cluster down -# Equivalent to: go run hack/e2e.go -- -v --build --up --test --down -# Note: running all e2e tests takes a LONG time! To run specific e2e tests, visit: -# https://git.k8s.io/community/contributors/devel/sig-testing/e2e-tests.md#building-kubernetes-and-running-the-tests -make test-e2e -``` - -See the [testing guide](/contributors/devel/sig-testing/testing.md) and [end-to-end tests](/contributors/devel/sig-testing/e2e-tests.md) -for additional information and scenarios. - -Run `make help` for additional information on these make targets. +This workflow is process-specific; for quick start build instructions for [kubernetes/kubernetes](https://git.k8s.io/kubernetes) please [see here](/contributors/devel/development.md#building-kubernetes-on-a-local-osshell-environment). ### 4 Keep your branch in sync From 0c71adbeb8081d5e3881eecb25f340d444f1c3c6 Mon Sep 17 00:00:00 2001 From: Josh Berkus Date: Thu, 4 Apr 2019 17:08:09 -0700 Subject: [PATCH 29/34] Initial version of the Shanghai Contributor Summit Page. This will eventually need both translation and further information, but for now at least there's content there. --- events/2019/06-contributor-summit/README.md | 37 +++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/events/2019/06-contributor-summit/README.md b/events/2019/06-contributor-summit/README.md index 901ace01d..3e1fa8a65 100644 --- a/events/2019/06-contributor-summit/README.md +++ b/events/2019/06-contributor-summit/README.md @@ -1 +1,38 @@ # 2019 Kubernetes Contributor Summit Shanghai + +## Essential Information + +June 24th, 2019
+10am to 5pm
+Shanghai Expo Center + +[Registration Page](https://www.lfasiallc.com/events/contributor-summit-shanghai-2019/) + +## Description + +This year's contributor summit in China will be full-day event for people who contribute to Kubernetes, or are interested in becoming contributors, whether through writing code, documentation, infrastructure, project management, or the many other places they can help. It will include three tracks: + +* The New Contributor Workshop is for those looking to find out how to become Kubernetes contributors; +* The Current Contributor Day is for attendees who are already contributing to Kubernetes, and want to learn more or do hands-on work at the Summit; +* The Documentation Sprints are for community members who want to help with writing documentation or translating it. + +## New Contributor Workshop + +The New Contributor Workshop is a 5-hour long tutorial, with participatory exercises, that covers the basics of contributing to Kubernetes and being part of its community. It is not possible to attend only part of the workshop, and you are expected to stay for the whole day. + +Attendees will be expected to bring a laptop, sign the Contributor License Agreement, and have a GitHub account. The workshop will be held in both Chinese and English, with live translation. + +## Current Contributor Day + +This day is for people who already contribute to Kubernetes and participate in its community and want a place to have working meetings, as well as contributors who have already taken the New Contributor Workshop and want to learn more in-depth contribution topics. + +Sessions during this day will be arranged by the community, and as such a final schedule will be posted here in early June. + +The Contributor Day will be held primarily in English, although one or two sessions may be in Chinese. + + +## Documentation Sprints + +The Documentation Sprints are for community members who want to help the project by either writing original documentation, updating and improving our documentation, or by translating the existing documentation into Chinese and other languages. + +Attendees must have some proficiency in written English, should bring laptops, and should sign the Kubernetes CLA. From 206c19fd555e240689a2473d9a4e1bf8422f7a8d Mon Sep 17 00:00:00 2001 From: Bob Killen Date: Fri, 5 Apr 2019 12:15:31 -0400 Subject: [PATCH 30/34] Correct GitHub handle for Quinton Hoole --- OWNERS_ALIASES | 4 ++-- sig-list.md | 4 ++-- sig-multicluster/README.md | 2 +- sigs.yaml | 6 +++--- wg-lts/README.md | 2 +- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index e169c26b3..aa9db1534 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -67,7 +67,7 @@ aliases: - brancz sig-multicluster-leads: - csbell - - quinton-hoole-2 + - quinton-hoole sig-network-leads: - thockin - dcbw @@ -133,7 +133,7 @@ aliases: wg-lts-leads: - tpepper - imkin - - quinton-hoole-2 + - quinton-hoole - youngnick wg-machine-learning-leads: - vishh diff --git a/sig-list.md b/sig-list.md index 580ab9f0d..a7bc0e921 100644 --- a/sig-list.md +++ b/sig-list.md @@ -38,7 +38,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[GCP](sig-gcp/README.md)|gcp|* [Adam Worrall](https://github.com/abgworrall), Google
|* [Slack](https://kubernetes.slack.com/messages/sig-gcp)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-gcp)|* Regular SIG Meeting: [Thursdays at 16:00 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[IBMCloud](sig-ibmcloud/README.md)|ibmcloud|* [Khalid Ahmed](https://github.com/khahmed), IBM
* [Richard Theis](https://github.com/rtheis), IBM
* [Sahdev Zala](https://github.com/spzala), IBM
|* [Slack](https://kubernetes.slack.com/messages/sig-ibmcloud)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-ibmcloud)|* Regular SIG Meeting: [Wednesdays at 14:00 EST (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Instrumentation](sig-instrumentation/README.md)|instrumentation|* [Piotr Szczesniak](https://github.com/piosz), Google
* [Frederic Branczyk](https://github.com/brancz), Red Hat
|* [Slack](https://kubernetes.slack.com/messages/sig-instrumentation)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-instrumentation)|* Regular SIG Meeting: [Thursdays at 17:30 UTC (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
-|[Multicluster](sig-multicluster/README.md)|multicluster|* [Christian Bell](https://github.com/csbell), Google
* [Quinton Hoole](https://github.com/quinton-hoole-2), Huawei
|* [Slack](https://kubernetes.slack.com/messages/sig-multicluster)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-multicluster)|* Regular SIG Meeting: [Tuesdays at 9:30 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Federation v2 Working Group: [Wednesdays at 7:30 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
+|[Multicluster](sig-multicluster/README.md)|multicluster|* [Christian Bell](https://github.com/csbell), Google
* [Quinton Hoole](https://github.com/quinton-hoole), Huawei
|* [Slack](https://kubernetes.slack.com/messages/sig-multicluster)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-multicluster)|* Regular SIG Meeting: [Tuesdays at 9:30 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* Federation v2 Working Group: [Wednesdays at 7:30 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Network](sig-network/README.md)|network|* [Tim Hockin](https://github.com/thockin), Google
* [Dan Williams](https://github.com/dcbw), Red Hat
* [Casey Davenport](https://github.com/caseydavenport), Tigera
|* [Slack](https://kubernetes.slack.com/messages/sig-network)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-network)|* Regular SIG Meeting: [Thursdays at 14:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Node](sig-node/README.md)|node|* [Dawn Chen](https://github.com/dchen1107), Google
* [Derek Carr](https://github.com/derekwaynecarr), Red Hat
|* [Slack](https://kubernetes.slack.com/messages/sig-node)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-node)|* Regular SIG Meeting: [Tuesdays at 10:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[OpenStack](sig-openstack/README.md)|openstack|* [Chris Hoge](https://github.com/hogepodge), OpenStack Foundation
* [Aditi Sharma](https://github.com/adisky), NEC Technologies India
* [Christoph Glaubitz](https://github.com/chrigl), iNNOVO Cloud
|* [Slack](https://kubernetes.slack.com/messages/sig-openstack)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-openstack)|* Regular SIG Meeting: [Wednesdays at 08:00 PT (Pacific Time) (biweekly starting Wednesday March 20, 2019)](https://docs.google.com/document/d/1bW3j4hFN4D8rv2LFv-DybB3gcE5ISAaOO_OpvDCgrGg/edit)
@@ -61,7 +61,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md) |[Component Standard](wg-component-standard/README.md)|* Architecture
* API Machinery
* Cluster Lifecycle
|* [Lucas Käldström](https://github.com/luxas), Luxas Labs (occasionally contracting for Weaveworks)
* [Dr. Stefan Schimanski](https://github.com/sttts), Red Hat
* [Michael Taufen](https://github.com/mtaufen), Google
|* [Slack](https://kubernetes.slack.com/messages/wg-component-standard)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-component-standard)|* Regular WG Meeting: [Tuesdays at 08:30 PT (Pacific Time) (weekly)](https://zoom.us/j/705540322)
|[IoT Edge](wg-iot-edge/README.md)|* Multicluster
* Networking
|* [Cindy Xing](https://github.com/cindyxing), Huawei
* [Dejan Bosanac](https://github.com/dejanb), Red Hat
* [Preston Holmes](https://github.com/ptone), Google
* [Steve Wong](https://github.com/cantbewong), VMWare
|* [Slack](https://kubernetes.slack.com/messages/wg-iot-edge)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-iot-edge)|* Regular WG Meeting: [Wednesdays at 17:00 UTC (every four weeks)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
* APAC WG Meeting: [Wednesdays at 5:00 UTC (every four weeks)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[K8s Infra](wg-k8s-infra/README.md)|* Architecture
* Contributor Experience
* Release
* Testing
|* [Davanum Srinivas](https://github.com/dims), Huawei
* [Aaron Crickenberger](https://github.com/spiffxp), Google
|* [Slack](https://kubernetes.slack.com/messages/wg-k8s-infra)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-k8s-infra)|* Regular WG Meeting: [Wednesdays at 8:30 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
-|[LTS](wg-lts/README.md)|* API Machinery
* CLI
* Node
|* [Tim Pepper](https://github.com/tpepper), VMware
* [Dhawal Yogesh Bhanusali](https://github.com/imkin), VMware
* [Quinton Hoole](https://github.com/quinton-hoole-2), Huawei
* [Nick Young](https://github.com/youngnick), Atlassian
|* [Slack](https://kubernetes.slack.com/messages/wg-lts)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-lts)|* Regular WG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
+|[LTS](wg-lts/README.md)|* API Machinery
* CLI
* Node
|* [Tim Pepper](https://github.com/tpepper), VMware
* [Dhawal Yogesh Bhanusali](https://github.com/imkin), VMware
* [Quinton Hoole](https://github.com/quinton-hoole), Huawei
* [Nick Young](https://github.com/youngnick), Atlassian
|* [Slack](https://kubernetes.slack.com/messages/wg-lts)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-lts)|* Regular WG Meeting: [Tuesdays at 09:00 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Machine Learning](wg-machine-learning/README.md)||* [Vishnu Kannan](https://github.com/vishh), Google
* [Kenneth Owens](https://github.com/kow3ns), Google
* [Balaji Subramaniam](https://github.com/balajismaniam), Intel
* [Connor Doyle](https://github.com/ConnorDoyle), Intel
|* [Slack](https://kubernetes.slack.com/messages/wg-machine-learning)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-machine-learning)|* Regular WG Meeting: [Thursdays at 13:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Multitenancy](wg-multitenancy/README.md)||* [David Oppenheimer](https://github.com/davidopp), Google
* [Tasha Drew](https://github.com/tashimi), VMware
|* [Slack](https://kubernetes.slack.com/messages/wg-multitenancy)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-multitenancy)|* Regular WG Meeting: [Tuesdays at 11:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
|[Policy](wg-policy/README.md)||* [Howard Huang](https://github.com/hannibalhuang), Huawei
* [Torin Sandall](https://github.com/tsandall), Styra
* [Yisui Hu](https://github.com/easeway), Google
* [Erica von Buelow](https://github.com/ericavonb), Red Hat
* [Michael Elder](https://github.com/mdelder), IBM
|* [Slack](https://kubernetes.slack.com/messages/wg-policy)
* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-wg-policy)|* Regular WG Meeting: [Wednesdays at 16:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)
diff --git a/sig-multicluster/README.md b/sig-multicluster/README.md index d3b1d3b90..62f368ccd 100644 --- a/sig-multicluster/README.md +++ b/sig-multicluster/README.md @@ -26,7 +26,7 @@ The [charter](charter.md) defines the scope and governance of the Multicluster S The Chairs of the SIG run operations and processes governing the SIG. * Christian Bell (**[@csbell](https://github.com/csbell)**), Google -* Quinton Hoole (**[@quinton-hoole-2](https://github.com/quinton-hoole-2)**), Huawei +* Quinton Hoole (**[@quinton-hoole](https://github.com/quinton-hoole)**), Huawei ## Contact * [Slack](https://kubernetes.slack.com/messages/sig-multicluster) diff --git a/sigs.yaml b/sigs.yaml index cbeefd9d6..34b5d205e 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1076,7 +1076,7 @@ sigs: label: docs leadership: chairs: - - name: Jared Bhatti + - name: Jared Bhatti github: jaredbhatti company: Google - name: Zach Corleissen @@ -1297,7 +1297,7 @@ sigs: github: csbell company: Google - name: Quinton Hoole - github: quinton-hoole-2 + github: quinton-hoole company: Huawei meetings: - description: Regular SIG Meeting @@ -2280,7 +2280,7 @@ workinggroups: github: imkin company: VMware - name: Quinton Hoole - github: quinton-hoole-2 + github: quinton-hoole company: Huawei - name: Nick Young github: youngnick diff --git a/wg-lts/README.md b/wg-lts/README.md index e98381d5d..60ab6fae3 100644 --- a/wg-lts/README.md +++ b/wg-lts/README.md @@ -26,7 +26,7 @@ The [charter](charter.md) defines the scope and governance of the LTS Working Gr * Tim Pepper (**[@tpepper](https://github.com/tpepper)**), VMware * Dhawal Yogesh Bhanusali (**[@imkin](https://github.com/imkin)**), VMware -* Quinton Hoole (**[@quinton-hoole-2](https://github.com/quinton-hoole-2)**), Huawei +* Quinton Hoole (**[@quinton-hoole](https://github.com/quinton-hoole)**), Huawei * Nick Young (**[@youngnick](https://github.com/youngnick)**), Atlassian ## Contact From ae9c1bfdaf2f8ef9da8901ba3f6657ca13fee2bf Mon Sep 17 00:00:00 2001 From: Tim Pepper Date: Mon, 25 Mar 2019 16:17:52 -0700 Subject: [PATCH 31/34] update patch release team contact for cherry picks We're adding a GitHub team for the patch managers and have a group mail alias to make it easier contacting the folks who shepherd cherry picks across the arc of time, documented in the release repo. Signed-off-by: Tim Pepper --- contributors/devel/sig-release/cherry-picks.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/contributors/devel/sig-release/cherry-picks.md b/contributors/devel/sig-release/cherry-picks.md index 097fef857..934111a35 100644 --- a/contributors/devel/sig-release/cherry-picks.md +++ b/contributors/devel/sig-release/cherry-picks.md @@ -40,9 +40,11 @@ branches. * Milestones on cherry-pick PRs should be the milestone for the target release branch (for example, milestone 1.11 for a cherry-pick onto release-1.11). - * You can find the current release team members in the - [appropriate release folder](https://git.k8s.io/sig-release/releases) for the target release. - You may cc them with `<@githubusername>` on your cherry-pick PR. + * During code freeze, to get attention on a cherry-pick by the current + release team members see the [appropriate release folder](https://git.k8s.io/sig-release/releases) + for the target release's team contact information. You may cc them with + `<@githubusername>` on your cherry-pick PR. + * For prior branches, check the [patch release schedule](https://git.k8s.io/sig-release/releases/patch-releases.md), which includes contact information for the patch release team. ## Cherry-pick Review From 5f410d716589c544481b0ba501ec6d524fc35877 Mon Sep 17 00:00:00 2001 From: Bob Killen Date: Fri, 5 Apr 2019 19:07:47 -0400 Subject: [PATCH 32/34] Update BCN Contributor Summit registration link. --- events/2019/05-contributor-summit/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/events/2019/05-contributor-summit/README.md b/events/2019/05-contributor-summit/README.md index 7ccf08bcd..de8883213 100644 --- a/events/2019/05-contributor-summit/README.md +++ b/events/2019/05-contributor-summit/README.md @@ -13,8 +13,8 @@ In some sense, the summit is a real-life extension of the community meetings and ## Registration - - [Sign the CLA](/CLA.md) if you have not done so already - - Registration form will be available soon + - [Sign the CLA](/CLA.md) if you have not done so already. + - [Complete the Registration form.](https://events.linuxfoundation.org/events/contributor-summit-europe-2019/register/) ## When and Where @@ -53,7 +53,7 @@ Combined Intro (Big Room) - All Workshop Participants: * Finding Your First Topic AKA Where Do I Fit In * Automation and Pull Request Demo/Practice -* Setting Up Your Dev Environment Lab +* Setting Up Your Dev Environment Lab * Install Golang (or straighten out gopaths) * Install Docker * Clone Kubernetes From e1efe712d243ec6a64a79d45e97b54ee675763f8 Mon Sep 17 00:00:00 2001 From: dsatya Date: Sat, 6 Apr 2019 11:24:34 +0530 Subject: [PATCH 33/34] Update internal links to creation and retirement --- sig-wg-lifecycle.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sig-wg-lifecycle.md b/sig-wg-lifecycle.md index 58dca09c5..f1cdea4c7 100644 --- a/sig-wg-lifecycle.md +++ b/sig-wg-lifecycle.md @@ -90,8 +90,8 @@ Sometimes it might be necessary to sunset a SIG or Working Group. SIGs/WGs may a [steering committee repo]: https://github.com/kubernetes/steering [discuss.kubernetes.io]: https://discuss.kubernetes.io [subproject]: /governance.md#subprojects -[Creation]: (#Creation) -[Retirement]: (#Retirement) +[Creation]: #Creation +[Retirement]: #Retirement [sig-governance.md]: /committee-steering/governance/sig-governance.md [SIG charter process]: /committee-steering/governance [wg-governance.md]: /committee-steering/governance/wg-governance.md From 770aea15be43faf22e4c40a9fe4b4da1c0357f62 Mon Sep 17 00:00:00 2001 From: rael Date: Tue, 9 Apr 2019 07:19:15 +0100 Subject: [PATCH 34/34] Add sig-docs-es team --- sig-docs/README.md | 1 + sigs.yaml | 2 ++ 2 files changed, 3 insertions(+) diff --git a/sig-docs/README.md b/sig-docs/README.md index 2fb8c1611..fb7ace230 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -59,6 +59,7 @@ Note that the links to display team membership will only work if you are a membe | @kubernetes/sig-docs-maintainers | [link](https://github.com/orgs/kubernetes/teams/sig-docs-maintainers) | Documentation maintainers | | @kubernetes/sig-docs-pr-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-docs-pr-reviews) | Documentation PR reviews | | @kubernetes/sig-docs-en-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-en-owners) | English content (default) | +| @kubernetes/sig-docs-es-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-es-owners) | Spanish content | | @kubernetes/sig-docs-de-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-de-owners) | German content | | @kubernetes/sig-docs-fr-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-fr-owners) | French content | | @kubernetes/sig-docs-it-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-it-owners) | Italian content | diff --git a/sigs.yaml b/sigs.yaml index 5ee0bb656..ab6237279 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -1136,6 +1136,8 @@ sigs: description: Documentation PR reviews - name: sig-docs-en-owners description: English content (default) + - name: sig-docs-es-owners + description: Spanish content - name: sig-docs-de-owners description: German content - name: sig-docs-fr-owners