Workshop de contribuição para o Kubernetes, como começar, entendendo como funciona a comunidade.

1. OLÁ!!!!
Antes de começarmos, seguem alguns links úteis:
● Assinar o CLA (Contributor License Agreement):
○ https://bit.ly/k8s-cla
● Slack do evento (fale com a gente!!)
○ https://cloud-native.slack.com/messages/kcd-brasil/
● Essa apresentação:
○ https://bit.ly/contrib-summit-br

2. Kubernetes
Contributors Workshop
Carlos Panato
Edson Celio
Ricardo Katz
Yago Nobre
Kubernetes Community Days Brazil

3. Antes de iniciarmos!

4. Nossa Experiência

5. Comunidade

6. O que você deve saber
● A comunidade K8s é organizada em sub-grupos
● Special Interest Groups, SIGs
○ Subprojects
● Working Groups, WGs
● Comites
● Grupos de usuários

7. O que você deve saber

8. Special Interest Group
Cada SIG é como se fosse
uma pequena comunidade do
k8s, pois este é um projeto
muito grande e não teria como
ter um grupo com mais de
2000 pessoas.

9. Tipos de SIGs
1.Feature Areas
2.Plumbing
3.Meta
4.Docs
5.Cloud Provider

10. SIGs relacionados a
funcionalidades
sig-auth
sig-apps
sig-autoscaling
sig-cli
sig-multicluster
sig-network
sig-node
sig-scalability
sig-scheduling
sig-service-catalog
sig-storage
sig-ui

11. “Plumbing” SIGs
sig-api-machinery
sig-cluster-lifecycle
sig-instrumentation

12. Meta
sig-architecture
sig-contributor-experience
sig-release
sig-testing

13. Documentação & Website
sig-docs
sig-docs-blog
sig-security-docs

14. Cloud Provider
Cada Cloud Provider é um subprojeto desse SIG.
● kubernetes-cloud-provider
● provider-alibaba-cloud
● provider-aws
● provider-azure
● provider-gcpprovider-huaweicloud
● provider-ibmcloud
● provider-openstack
● provider-vsphere

15. Working Groups & Subprojects
Working Groups: esforço entre SIGs
Subprojects: Área de foco em um SIG
Para:
● Ferramentas (ex. Kubectl)
● Objetivos (ex. Code Cleanup, Contributor Site)
● Áreas (ex. Machine Learning)

16. Working Groups
wg-api-expression
wg-component-standard
wg-data-protection
wg-iot-edge
wg-multitenancy
wg-naming
wg-policy
wg-reliability
wg-structured-logging

17. Subprojetos
Os projetos estão em uma
outra org do GitHub
kubernetes-sigs/
cluster-api
kustomize
kubespray

18. User Groups
Sem codebase ownership
Tópicos de interesse são
compartilhados entre um
grande grupo de usuários
ug-big-data
ug-vmware-users

19. Comitês
Governança orientada a
projetos
Apenas por convite ou
eleições
Três comitês:
Steering
Security Response
Code of Conduct
https://github.com/kubernetes/community/blob/master/README.md#governance

20. Escolhendo um SIG
1. Procure os projetos ou áreas que você gostaria de ajudar.
2. Veja quais SIGs/subproject cobre esta(s) área(s)
a. Pergunte no #sig-contribex
3. Junte-se ao SIG/subprojeto
a. no Slack
b. lista de emails

21. Entrando em um SIG
1. Entre na mailing-list do SIG.
Qualquer um pode entrar!
Ao entrar na lista você já recebe os convites
para as agendas do SIG!
1. Parabéns! Você agora faz parte de um SIG.

22. Referência rápida
Governance reference
Project Group List
sigs.yaml configuration file

23. Comunicação

24. Mantendo contato
● Como fazemos?
○ Mailing List / Lista de emails
○ Slack
○ Reuniões no Zoom
● Iniciativas de reunião assíncronas:
○ Alternando entre threads no Slack e reuniões no Zoom - Experiência no #sig-
contribex
○ Reuniões amigáveis com timezone APAC para o time de Releases
○ Mais conversas no Slack e lista de emails, depender menos de reuniões

25. Meetings

26. Um pequena tour nos
repositórios do
Kubernetes

27. Projetos
k/community
k/enhancements
k/steering
k/test-Infra
k/perf-tests
Contributor-experience
Release, Architecture
Steering Committee
Testing
Scalability, Testing
Repositório SIG(s) associada

28. Developer Tools
k/sample-controller
k/sample-apiserver
k/code-generator
k/kubernetes-template-project

29. Repositórios de staging
api
apiextensions-apiserver
apimachinery
apiserver
client-go
code-generator
kube-aggregator
metrics
sample-apiserver

30. SIG Repos
k/release
k/federation
k/autoscaler

31. Cloud Provider Repos
k/cloud-provider-azure
k/cloud-provider-gcp
k/cloud-provider-openstack
k/cloud-provider-alibaba-cloud
k/cloud-provider-vsphere
k/cloud-provider-aws

32. Produtos & Ferramentas
kubeadm
kubectl
kops
kompose
ingress-nginx
minikube
dashboard
kube-openapi
k/k8s.io

33. kubernetes-sigs
subprojects

34. Docs/Website
k/website - docs

35. Estrutura do k/website
● Website
● Documentação
● Blog
● Referências (e Glossário)
https://kubernetes.io/docs/home/

36. Estrutura do k/website
● Escrito em markdown (.md) e deploy feito com Hugo
https://kubernetes.io/docs/home/

37. Estrutura do k/website
● Escrito em markdown (.md) e deploy feito com Hugo
https://kubernetes.io/docs/home/

38. Localização
https://kubernetes.io/docs/home/
https://www.w3.org/International/questions/qa-i18n

39. Localização: Português (PT-BR)
De que forma posso contribuir?
https://kubernetes.io/pt-br/docs/contribute/

40. Localização PT-BR: Por onde começar
Entender como funciona o projeto
https://github.com/kubernetes/website/blob/main/README-pt.md

41. Localização PT-BR: Por onde começar
Entrar no canal do projeto no slack do kubernetes
(https://slack.k8s.io/)
#kubernetes-docs-pt
https://bit.ly/3K84gbRz

42. Localização PT-BR: Por onde começar
Marcar a página/atividade que vai traduzir na planilha de
acompanhamento e começar sua atividade!
https://bit.ly/3K84gbRz

43. Localização PT-BR: Por onde começar
Quando considerar que sua contribuição está pronta, abrir um PR
(Pull Request) e aguardar as interações de revisão
https://github.com/kubernetes/website/pulls

44. Localização PT-BR
https://github.com/ashleymcnamara/gophers/blob/master/Kubernetes_Gophers.png
Pronto, você já consegue trabalhar na sua contribuição para a
documentação do kubernetes!

45. Qual é o processo para
adicionar uma feature?

46. GitHub Issue -
Feature Request
GitHub PR - Feature
Implementation

47. GitHub Issue -
Feature Request
GitHub PR - Feature
Implementation
Design

48. KEP!
Kubernetes Enhancement Proposal
https://git.k8s.io/enhancements

49. KEP!
Kubernetes Enhancement Proposal
https://git.k8s.io/enhancements

50. Quando um KEP deve ser criado?
● Mudanças significativas
● Envolve vários grupos/areas
● Mudança importante no código
● Mudanças que impactam UX

51. Quando enviar um KEP?
● Mudanças significativas
● Envolve vários grupos/areas
● Mudança importante no código
● Mudanças que impactam UX
● Correção de testes
● Refatoração de código
● Adicionar mais logs
● Adicionar mais eventos
● Melhoria na performance sem impacto
em UX

52. Repositório principal
A maioria dos SIGs "patrocina" o monolito.
As áreas que cada SIG é responsável pode ser
encontradas em https://git.k8s.io/community/sigs.yaml
kubernetes/kubernetes

53. Saímos para o almoço e
voltamos 12:30!!

54. Como achar a sua
primeira Issue?

55. Good first issues
https://go.k8s.io/good-first-issue
Source: Bob Killen/Sahdev Zala on #sig-contribex

56. Após a primeira issue
https://go.k8s.io/help-wanted
Source: Bob Killen/Sahdev Zala on #sig-contribex

57. Refactor, documentação de
código, escrita de testes,
correção de testes!

58. …. e não apenas com código
https://k8s.dev/docs/guide/non-code-contributions/

60. Escada de responsabilidades

61. Programas de Mentoria

62. Programas de Mentoria
● Meet Our Contributors - #meet-our-contributors
● Mentoria de grupos
● Google Summer of Code
● Linux Foundation LFX Mentorship Program

63. Programa
Release Shadow

64. Kubernetes Release Team
● Periodicamente uma nova versão do Kubernetes é liberada
● Verifica e Gerencia as features e se estarão disponíveis para serem liberadas
dentro de uma janela de tempo
● Garante que os artefatos gerados no processo de release tenham um certo
nível de qualidade
Image Source: https://git.k8s.io/sig-release/release-team/release-team.svg

65. O que é o Release Shadow program?
● Segue o modelo de aprendizagem
● Aprende-se fazendo
● Ajuda os contribuidores a ampliar sua área de conhecimento
https://git.k8s.io/sig-release/release-team/shadows.md

66. Como posso participar?

67. O tenho que fazer?
1. Leia o role handbooks para entender as responsabilidades de cada papel
2. Pergunte no #sig-release em casos de dúvidas
3. Preencha o formulário
4. Espere pelo anúncio dos selecionados

68. Contributor License Agreement
● Contribuidores do projeto Kubernetes precisam assinar a CLA
● Requerido para determinar o status legal das contribuições
● Existem dois tipos de CLA:
1. Individual
2. Corporativo
Nota: Verifique na sua empresa se você deve assinar o CLA corporativo
https://git.k8s.io/community/CLA.md

69. Labels
Como falar com a automação do K8s

71. https://issues.k8s.io

72. Labels necessários para Issues
Na criação:
sig/
kind/
Para adicionar depois:
priority/
https://go.k8s.io/bot-commands

73. SIG Label
Label
sig/auth
sig/testing
sig/api-machinery
sig/node
Comando do Bot
/sig auth
/sig testing
/sig api-machinery
/sig node

74. Adicionando um label a um pull request ou issue

75. Kind Label
kind/bug kind/failing-test
kind/feature kind/flake
kind/documentation kind/cleanup
kind/design
Exemplo do comando do bot : /kind feature

76. priority/ label
priority/critical-urgent
priority/important-soon
priority/important-longterm
priority/backlog
priority/awaiting-evidence
Exemplo do comando do bot : /priority critical-urgent

77. Additional Labels for Pull Requests
release-note
approved
lgtm
cherry-pick-approved (apenas em certos estágios do ciclo de release)

78. https://prs.k8s.io

79. Labels podem te ajudar a encontrar sua primeira issue!
help wanted
● Baixa barreira de entrada
● Tarefa normalmente fácil
good first issue
● Focado em novos contribuidores
● Tem suporte e orientação

82. Bots

83. Diga Oi para o k8s-ci-robot!
@TheNikhita

84. PRs e Bots: GitHub PR Flow

85. PRs e Bots: Kubernetes PR Flow
1. Você abre um Pull Request (PR)
2. Você adiciona labels & notas
3. Bots valida e comenta nos PR
release-note cncf-cla: no needs-ok-to-test needs-kind needs-sig
1. Você adiciona mais labels & notas & resolve comentários de
review
2. SIGs & OWNERS review e /approve → approved
3. Outros contribuidores podem dar /lgtm → lgtm
4. Tests ok
5. Tide merges o PR
https://prow.k8s.io/command-help

86. Comando
/assign @username
/retest
/close
/cc @username
Result
Associa um usuário
Re-executa testes que falharam
Fecha PRs e Issues
Marca um usuário p/ revisão
PRs e Bots: Comandos úteis

87. PRs e Bots: Reviewers/Approvers

88. PRs e Bots: Reviewers/Approvers
● Adiciona /sig label
● Fale com o seu mentor(s)
● Entre em contato com a SIG
○ atenda uma SIG meeting
○ pergunte no Slack
○ envie um email para a list
● Entre em contato com OWNERS

89. PRs e Bots: Test Results

90. PRs e Bots: Following Up
Respondas as questões
Resolva:
Mensagens do Bot
Comentários no código
Falhas nos Testes

91. Hands-on session

94. Bem-Vindo!!