개발 프로세스
GitLab v19.2GitLab에 기여하기 위한 개발 프로세스 관련 정보는 다음 주제를 참조하세요. Cells: Cells 아키텍처와 Cells 호환 코드 작성 방법 이해 기존 컴포넌트 적용 및 새 컴포넌트 도입 가이드 코드 리뷰 가이드라인: 코드 리뷰 및 코드 리뷰 받기
GitLab에 기여하기 위한 개발 프로세스 관련 정보는 다음 주제를 참조하세요.
프로세스#
필수 읽기:
-
Cells: Cells 아키텍처와 Cells 호환 코드 작성 방법 이해
-
코드 리뷰 가이드라인: 코드 리뷰 및 코드 리뷰 받기
-
데이터베이스 리뷰 가이드라인: 데이터베이스 관련 변경 사항 및 복잡한 SQL 쿼리 리뷰 및 리뷰 받기
보완 읽기:
-
GitLab.com에서 ChatOps 접근 요청 (GitLab 팀원 전용)
개발 가이드라인 리뷰#
개발 가이드라인 변경 시, 경험 있는 GitLab 팀원에게 리뷰 및 승인을 요청하세요.
예를 들어, 특정 그룹에서 독점적으로 사용하는 새 내부 API를 문서화하는 경우, 해당 그룹의 구성원 중 한 명에게 엔지니어링 리뷰를 요청하세요.
오타와 같은 작은 수정 사항은 최소 Maintainer 권한이 있는 사용자가 머지할 수 있습니다.
광범위한 변경 사항#
일부 변경 사항은 둘 이상의 그룹에 영향을 미칩니다. 예를 들면:
-
코드 리뷰 가이드라인 변경 사항
-
커밋 메시지 가이드라인 변경 사항
-
GitLab 개발의 기능 플래그 관련 가이드라인 변경 사항
-
기능 플래그 문서화 가이드라인 변경 사항
이러한 경우 다음 워크플로를 사용하세요:
-
팀 구성원에게 피어 리뷰를 요청하세요.
-
해당 영역을 담당하는 Engineering Manager(EM) 또는 Staff Engineer의 리뷰 및 승인을 요청하세요:
해당 영역을 담당하는 EM 또는 Staff Engineer가 작성한 머지 리퀘스트의 경우 이 단계를 건너뛸 수 있습니다.
영향을 받는 그룹이 여러 개인 경우 각 영역의 EM/Staff Engineer 수준의 승인이 필요할 수 있습니다.
-
리뷰를 완료한 후, 머지 리퀘스트의 EM/Staff Engineer 작성자/승인자와 협의하세요.
여러 영역에 걸친 중요한 변경 사항인 경우, 개발 가이드라인의 DRI인 VP of Development에게 최종 리뷰 및 승인을 요청하세요.
모든 Maintainer가 머지 리퀘스트를 머지할 수 있습니다.
기술 문서 작성 리뷰#
기술 문서 작성자의 리뷰를 원하는 경우, #docs Slack 채널에 메시지를 게시하세요.
기술 문서 작성자가 반드시 콘텐츠를 리뷰할 필요는 없으며, 머지 리퀘스트 작성자 이외의 모든 Maintainer가 머지할 수 있습니다.
머지 리퀘스트 승인 설정#
gitlab-org/gitlab 프로젝트는 GitLab 변경 관리 Controls의 CHG-04 Control을 충족하기 위해 다음 승인 설정을 적용합니다:
CODEOWNERS 파일에서 코드 오너를 업데이트하려면 코드 오너 승인 프로세스를 따르세요.
로컬에서 리베이스하거나 제안 사항을 적용하면 커밋 추가로 간주되어 승인이 초기화됩니다.
UI에서 리베이스하거나 /rebase 빠른 액션을 사용하면 승인이 초기화되지 않습니다.
리뷰어 가치#
리뷰어 또는 리뷰를 받는 사람으로서, GitLab에서 추구하는 리뷰어 가치를 숙지하세요.
또한, 모든 문서 콘텐츠는 문서 스타일 가이드를 따라야 합니다.
언어별 가이드#
Go 가이드#
셸 스크립팅 가이드#
명확한 서면 소통#
이슈, 머지 리퀘스트, 기타 커뮤니케이션 수단에서 댓글을 작성할 때 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", "OPTIONAL"과 같은 용어를 사용하는 경우 IETF 표준을 따르세요.
이를 통해 다양한 문화권의 팀원들이 사용되는 용어를 명확히 이해할 수 있습니다.