kubernetes contributing to · cloud native computing foundation incubating service discovery...

47
Contributing to kubernetes

Upload: others

Post on 28-May-2020

4 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Contributing to kubernetes

Page 2: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Who am I?

Senior Software Engineer at Gojek

Organizer at Kubernetes & Cloud Native Meetups in Jakarta and Bandunghttps://www.meetup.com/jakarta-kubernetes/https://www.meetup.com/Microservice-JKT/https://www.meetup.com/Kubernetes-and-Cloud-Native-Bandung/

Kubernetes Maintainerhttps://kubernetes.io/

CNCF Ambassadorhttps://cncf.io

Google Developer Expert

You can find me at @girikuncoro

Page 3: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Today’s Tutors

● Joshua Bezaleel (@joshuabezaleel)

● Zufar Dhiyaulhaq (@zufardhiyaulhaq)

Page 4: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Cloud Native Computing Foundation

Incubating

Service Mesh StorageService Discovery

Distributed Tracing Software Update Spec

Security

Graduated

Package Management

Networking APILogging Remote Procedure CallDistributed Tracing API

Container Runtime

Container Runtime

Messaging

Orchestration Service ProxyMonitoring

RegistryStorage Key/Value Store Policy

Source: CNCF Overview

Page 5: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec
Page 6: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Community

Page 7: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

slack.kubernetes.io

Page 8: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

git.k8s.io

Page 9: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

youtube.com/c/kubernetescommunity

Page 10: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Contributing

Page 11: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

GovernanceSIGs Special Interest Groups

Persistent open groups that focus on a part

of the project.

UGs User Groups

Groups for facilitating communication and

discovery of information

WGs Working Groups

Temporary groups that are formed to

address issues that cross SIG boundaries.

Committees

Sets of people that are chartered to take on

sensitive topics.

https://git.k8s.io/community/governance.md

Page 12: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Release ContribX PM Docs Testing

API Machinery CLI UI Multi-cluster Windows Auth

Apps

Autoscaling

AWS

Big Data

Cluster Lifecycle Cluster Ops Instrumentation

Network Node

On Prem OpenStack

Scalability

Scheduling

Service Catalog

Storage Rktnetes Resource Management

Cloud

Steering Committee

Project

Horizontal

Vertical

App

RM

Adm

inC

loud

Architecture

AzureGCP

Container Identity

Cluster APIKubeadm Adoption

Workgroup

SIG

Committee

CoC Committee

Conformance

VMware

ApplyApp Def

Policy

Machine Learning

Multi-tenancy

https://git.k8s.io/community/sig-list.md

Page 13: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Contributor Ladder

Subproject Owner

Set priorities and approve proposals for subprojectResponsibility and leadership for entire repository/directory

ApproverApprove contributions for acceptanceHighly experienced reviewer and contributor in subproject

Reviewer History of reviewing; reviews frequentlyAuthorship in subproject

Member Active contributor to the projectSponsored by two Reviewers

Non-member Contributors

Page 14: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Choose what to work on

Look in the Contributor Role Board

https://discuss.kubernetes.io/c/contributors/role-board

Related to your job or topics of your interest

https://git.k8s.io/community/sig-list.md

Write code in the language you are comfortable with

https://github.com/kubernetes-client

Non-code contributions

https://git.k8s.io/community/contributors/guide/non-code-contributions.md

Page 15: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec
Page 16: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Look for issues

Check the labels of your SIG

https://github.com/kubernetes/kubernetes/issues

Look for the help wanted label

Denotes an issue that needs help from a contributor.Must meet "help wanted" guidelines.

Start with good first issue labeled issues

Denotes an issue ready for a new contributor,according to the "help wanted" guidelines.

Page 17: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Read the Docs

Read the contributors guide

https://git.k8s.io/community/contributors/guide

Read the developer guides

https://git.k8s.io/community/contributors/devel

Understand the concepts

https://kubernetes.io/docs/concepts

Read the Kubernetes Design Documents and Proposals

https://git.k8s.io/community/contributors/design-proposals

Page 18: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Write the Docs

Join SIG-Docs

https://git.k8s.io/website

Join the SIG-Docs slack channel

#sig-docs

Write and improve documentation

https://kubernetes.io/docs/contribute/

Write content

https://kubernetes.io/bloghttps://discuss.kubernetes.io

Page 19: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Write the Docs in your language

Join the SIG-Docs channel for your language

- #kubernetes-docs-de

- #kubernetes-docs-es

- #kubernetes-docs-fr

- #kubernetes-docs-hi

- #kubernetes-docs-id

- #kubernetes-docs-it

- #kubernetes-docs-ja

- #kubernetes-docs-ko

- #kubernetes-docs-pt

- #kubernetes-docs-zh

Write content in your language

https://discuss.kubernetes.io/c/regional-discussions

Page 20: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Building kubernetes.io

Page 21: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Linux Foundation CLA

The Contributor License Agreement

Defines the legal status of the contributed code in two different types of Contributor License Agreements (CLAs):

🏠 Individual contributors🏢 Corporations

Kubernetes can only accept original source code from CLA signatories

https://git.k8s.io/community/CLA.md

linuxfoundation.org

Page 22: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Hugo

The Kubernetes documentation is written in Markdown and processed and deployed using Hugo.

Hugo is one of the most popular open-source static site generators

https://github.com/gohugoio/hugo

Read the Hugo documentation if you want to learn more

https://gohugo.io/documentation/

Check the documentation style guide

https://kubernetes.io/docs/contribute/style/style-guide/

gohugo.io

Page 23: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Git and GitHub

github.comThe website source is in GitHub at https://github.com/kubernetes/website

Page 24: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Netlify

netlify.comThe Kubernetes is built and deployed using Netlify

Page 25: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Let’s contributeto sig-docs-id!

Page 26: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Join to the Kubernetes Slack

slack.k8s.io

#kubernetes-docs-id

Page 27: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Participate in the pull requests reviewsbit.ly/k8s-sig-docs-id-prs

Add new content to the Indonesian docsbit.ly/k8s-docs-id-m2

label:language/id

Be part of Indonesian localization team

Page 28: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Fork the kubernetes website repo

https://github.com/kubernetes/website

Page 29: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Gitventure time

Page 30: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

https://git.k8s.io/community/contributors/guide/github-workflow.md

Page 31: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Clone your fork

Page 32: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Add Upstream

Page 33: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Checkout a new branch for the contribution

Page 34: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Commit your changes to your branch

Page 35: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Install Hugo to run the site locally

https://gohugo.io/getting-started/installing

Page 36: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

https://github.com/kubernetes/website/blob/master/README-id.md

Or if you’ve installed hugo: hugo server -D -F

Page 37: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

http://localhost:1313/

Page 38: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Push the changes to your branch

Page 39: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Create a pull request

Page 40: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Linux Foundation CLA

https://www.linuxfoundation.org/

Page 41: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Build succeeded: Preview site

Page 42: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Build succeeded: Next Steps

Page 43: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Labels for required for publication: lgtm/lgtm from reviewers

Page 44: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Labels for required for publication: approved/approve from owners

Page 45: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Live!

Page 46: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Approvers/Reviewers for sig-docs-id

Approvers

● Giri Kuncoro (@girikuncoro)

● Irvi Aini(@irvifa)

Reviewers

● Yudi Phanama (@phanama)

● Danni Setiawan (@danninov)

● Iqbal Farabi (@qbl)

Page 47: kubernetes Contributing to · Cloud Native Computing Foundation Incubating Service Discovery Service Mesh RegistryStorage Key/Value Store Distributed Tracing Software Update Spec

Gopher Kubernetes by @ashleymcnamaraThis presentation is licensed under a Creative Commons Attribution 4.0 International License.

See https://creativecommons.org/licenses/by/4.0/ for more details.