본문으로 건너뛰기
Kubernetes PR이 머지되기까지의 커뮤니티 논의
목차

Kubernetes PR이 머지되기까지의 커뮤니티 논의 (2021-10)

원문 정보

2021년 당시 카카오는 Kubernetes를 DKOS라는 이름의 KaaS로 제공했고, 카카오톡을 비롯한 대다수 서비스를 그 위에서 운영했습니다. 클라우드플랫폼팀의 bg.chun은 kubelet과 컨테이너 런타임, 둘 사이에 쓰이는 CRI에 기여한 경험을 공유했습니다.

리뷰를 부탁할 담당 SIG

PR을 올렸다고 리뷰가 저절로 진행되지는 않습니다. 자동으로 배정된 리뷰어가 적극적으로 검토하거나 담당 메인테이너가 리뷰와 머지를 해 주는 경우는 많지 않습니다. bg.chun은 변경한 코드를 맡는 SIG(Special Interest Group)의 Slack 채널을 찾아, PR의 한 줄 설명과 링크를 붙여 정중하게 리뷰를 요청하라고 권합니다.

Kubernetes의 각 SIG는 자기 역할과 영역을 맡아 프로젝트를 관리합니다. 여러 SIG가 함께 논의할 고정 주제가 있으면 Working Group을 만들고, 정책 결정은 가장 위의 Steering Committee가 맡습니다. 코드 기여자가 코멘트나 Slack으로 주로 소통할 상대는 담당 SIG에서 승인 권한을 가진 메인테이너입니다.

변경의 배경을 먼저 읽을 KEP

구현을 살피기 전에 참고할 자료도 있습니다. SIG별로 관리하는 KEP(Kubernetes Enhancement Proposal)는 Kubernetes의 개선 사항을 계속 추적하는 문서입니다. 기능을 제안한 배경과 변경 내용뿐 아니라 스케줄러 프레임워크 같은 컴포넌트의 설계도 담길 수 있어, 관련 히스토리와 설계 사상, 주요 사용 사례와 제한사항을 이해하는 데 도움이 됩니다.

모든 코드 변경에 KEP가 필요한 것은 아닙니다. 어떤 변경을 하려는지에 따라 준비 과정이 달라집니다.

KEP 작성 여부변경의 범위
작성하지 않는 경우버그픽스, 오브젝트나 기능의 동작을 바꾸지 않는 개선·리팩토링, 성능 향상, 동작하지 않는 테스트 코드 수정
작성하는 경우새 오브젝트나 기능 제안, 기존 API나 기능을 확장·개선하면서 동작을 바꾸는 변경, 사용자 경험에 큰 영향을 주는 변경

KEP가 필요한 변경이라면 순서가 정해져 있습니다. KEP를 승인받고 먼저 머지한 뒤에야 관련 코드를 기여할 수 있습니다.

bg.chun이 관심 있게 읽은 제안

  • sig-node: In-place Update of Pod Resources, Pod level resource limit, Removing dockershim from kubelet, Node system swap support, Cgroup V2
  • sig-cloud-provider: Removing In-Tree Cloud Provider Code
  • sig-scheduling: Scheduling Framework

Pod level resource limit는 당시 아직 머지되지 않은 상태였습니다. bg.chun은 메인테이너 Tim Hockin이 In-place Update of Pod Resources와 Pod level resource limit에 꾸준히 방문한다는 점을 보고, 머지않은 미래에 만나볼 수 있는 개선이라고 예상했습니다.

CI를 시작하게 하는 ok-to-test 라벨

CLA는 기여할 계정으로 서약해야 합니다. PR을 만들고 코드를 기여할 때 필수로 확인하는 항목이기 때문입니다. 행동지침(Code of Conduct)과 커뮤니티가 기여자에게 기대하는 바와 역할도 미리 숙지해야 합니다.

커밋이 준비되면 대상 저장소를 Fork해 PR을 보냅니다. 저장소에 직접 branch를 만들 수는 없습니다. 코드는 주로 kubernetes repo, KEP는 enhancements repo, 문서는 website repo가 대상이며, 여기서 설명하는 리뷰와 CI 절차는 kubernetes repo를 기준으로 합니다.

담당 SIG의 Slack 채널을 찾아가라는 조언에는 CI를 시작하려는 이유도 있습니다. Kubernetes CI 시스템(prow)은 ok-to-test 라벨이 붙은 PR만 처리하는데, 이 라벨을 붙일 수 있는 사람은 Kubernetes Org 멤버뿐입니다.

라벨이 붙으면 지정된 테스트와 무작위로 뽑은 일부 테스트가 실행됩니다. 별다른 이유 없이 테스트 중 오류가 나서 실패하는 경우도 잦습니다. 이런 경우에는 /retest 또는 /retest {TEST_NAME}을 코멘트로 남겨 다시 테스트해야 합니다.

큰 변경의 이유를 설명할 주간 미팅

충분한 리뷰를 받아 lgtm 라벨이 붙으면 승인 권한자와 소통할 차례입니다. SIG 리더는 해당 SIG가 관리하는 소스코드의 승인 권한을 가지며, 일부 Org 멤버는 특정 기능이나 소스 트리에 한정된 승인 권한을 갖습니다. 이들의 관심을 얻는 가장 좋은 방법은 Slack에서 멘션하거나 주간 미팅에 참여하는 것입니다.

간단한 버그픽스는 Slack에서 논의하는 것만으로 머지되기도 합니다. 새로운 기능을 제안하거나 API 동작을 바꾸는 등 KEP 작성·수정이 따르는 변경이라면, 주간 미팅에서 왜 그 개선이 필요한지 커뮤니티 구성원을 설득해야 합니다. 발언하려면 SIG별 아젠다 보드에 안건을 먼저 등록합니다.

아젠다 보드는 늘 가득 차 있습니다. 큰 변경은 지원할 사용 사례와 구현 방향을 여러 미팅에 걸쳐 오래 논의하기 때문입니다. 여러 SIG가 함께 다뤄야 하는 사안이라면 다른 SIG 리더를 주간 미팅에 초대하거나 별도 미팅을 잡기도 합니다.

구성원들의 동의를 얻고 승인자가 모든 피드백을 반영했다고 판단하면 PR에 approved 라벨이 붙습니다. 마지막으로 CI 시스템이 CLA 서약과 여러 조건을 확인하고, 모두 충족하면 master 브랜치에 머지합니다.

kubelet 기여에서 얻은 내부 구현 지식

가장 쉽게 시작할 수 있는 기여는 문서 작성, 한국어 번역, 오탈자 수정입니다. bg.chun이 선호하는 쪽은 관심 있는 컴포넌트나 기능의 히스토리와 구현을 깊이 살피는 소스코드 Deep Dive입니다. 문서에 나오지 않는 세세한 동작이나, 알려져 있지만 아직 처리하지 않은 엣지 케이스까지 확인할 수 있기 때문입니다.

그렇게 얻은 지식은 실서비스의 문제를 다룰 때 도움이 됐습니다. bg.chun은 기여 과정에서 CRI와 OCI 표준 컨테이너 런타임의 내부 구현까지 자세히 살폈고, 이를 바탕으로 여러 이슈를 해결하고 다양한 컨테이너 런타임을 테스트했습니다. 특정 기능에 크게 의존하는 서비스를 개발하거나 컴포넌트의 내부 동작이 궁금하다면 소스코드를 깊이 읽어 보라고 강하게 권합니다.

코드 기여 자체를 적극 권하지는 않습니다. 함께 작업하는 기여자 사이의 의견 충돌이나 담당 메인테이너의 반대로 진행이 매끄럽지 않을 수 있어서입니다. 이 경험을 전한 대상도 개인적이거나 업무상 이유로 기여가 필요한 사람들입니다.

글을 쓸 당시 bg.chun은 Kubernetes Organization 멤버로 활동하며 자신이 기여한 기능의 개선을 추적하고 관련 PR에 리뷰를 남기고 있었습니다. 후속 글에서는 파드 오브젝트를 생성한 뒤 노드의 kubelet이 파드와 컨테이너를 만드는 자세한 과정을 분석할 예정이라고 밝혔습니다.

마지막 수정 일자