Development/gerrit/ko

From The Document Foundation Wiki
Jump to: navigation, search

이 페이지는 코드 검토 도구 gerrit.libreoffice.org의 설명 항목 페이지이며 리브레오피스에서 어떻게 사용하는지 설명합니다.

게릿 알아서 설정하기

시작하기 전에: 문제 해결 도움말

아래 순서는 따라하기 쉽고 간편합니다. 다만, 어딘가에서 문제에 부딪혔다면, 다음 방법으로 도움을 받으세요:

게릿에 처음 등록하기

게릿에 새 계정을 만들려면, 게릿에 들어가서 페이지 오른쪽 상단의 “Register” 링크를 누르신 후, 원하는 OpenID (OpenID 제공 서비스 목록) 또는 OAuth2 제공자를 선택하여 로그인하세요.

현재 OAuth2 제공 서비스는 두군데만 지원합니다(OAuth2 플러그인 활성화 대기):

  • GitHub
  • Google

게릿 계정 전환(다른 식별 정보 링크)

다른 OpenID 또는 OAuth2 계정을 동일한 게릿 사용자 계정에서 쓸(링크할) 수 있습니다.

Gnome-dialog-warning.svg

경고:
새 계정으로 로그인하면 게릿에 새 계정을 만들고 해당 계정에 새 OpenID|OAuth2 인증 정보를 연결하므로 기존 계정으로 연결할 수 없습니다!


새 OpenID 또는 OAuth2 계정을 기존 게릿 계정에 연결하려면:

  1. 기존 계정으로 로그인하고
  2. User ▸ Settings ▸ Identites로 이동하거나, https://gerrit.libreoffice.org/#/settings/web-identities 주소로 바로 이동하신 후
  3. "Link another identity" 버튼을 누르시고
  4. 대신 연결할 인증 정보를 선택하세요.
  5. 로그인하시면
  6. 끝납니다

게릿 알아서 설정하기 - 쉬운 방법

리브레오피스/코어 코드를 이미 체크아웃했다면 ./logerrit setup 명령을 실행하여 ssh 키 설정과 접속 설정을 자동으로 진행할 수 있으며, 진행이 안되는 경우는 다음 세 단계를 따라가시면 됩니다. 필요한 경우 다음 단계를 따르세요.

프로그램에서 https://gerrit.libreoffice.org 사이트로 이동한 후, Register를 눌러 들어가서 사용자 이름을 입력하고 기억하세요. 프로그램에서 공개 SSH 키를 자동으로 만들고 화면에 뿌린 후 /home/[username]/.ssh/id_rsa.pub에 자동으로 전환합니다. 이 키 파일은 'ssh-rsa'로 시작합니다. 웹 가이트 등록 과정에서 이 키를 반드시 입력해야합니다(또는 나중에 게릿을 동작하게끔 하려면 SettingsSSH Public Keys에 추가해야합니다).

./logerrit test 명령 실행에 실패하고 ssh -vvv logerrit 명령에서 ~/.ssh/config 파일에 잘못된 권한 값을 설정했다는 메시지가 뜨면, ~/.ssh에 들어가서 chmod 600 config 명령을 실행하세요.


다른 방법은 직접 접근해서 이리저리 만져보는 방법이며, 세부 방법은 Development/gerrit/setupen에 있습니다.

게릿에 패치 보내기

기여자 명단에 자신을 추가하기

리브레오피스 프로젝트에 처음 패치를 기여한다면, 개발자 및 기여자 명단en에 우선 자신을 추가하고(방법은 페이지에 다 나와있습니다) 기여 라이선스 상태를 적어넣으십시오.

검토할 패치 제출하기

바꾼 내용을 만들고 검토할 내용을 게릿으로 push 하십시오 (공식 게릿 문서는 여기en에 있습니다).

git checkout -b <a_local_branch_name_of_your_choice>
# Do your code changes, make sure it will build
git add file [file ...] # all the new files _and_ changed files
git commit
./logerrit submit master

참고: `logerrit` 명령을 동작하게끔 게릿 설정을 했는지 먼저 확인하십시오. 방법은 여기en에 있습니다.

참고: git add + git commit 단계는 'git gui' 명령으로 처리할 수 있으며, 제출 제목줄은 65문자를 넘으면 안되며, 제출 메시지는 한 줄 당 문자 갯수가 70개를 넘으면 안됨을 기억하세요.

참고: 마스터 브랜치로 제출하고나면, 마스터 브랜치 최근 버전으로 (re)base하여, 젠킨스에서 가능한한 ccache를 통해 CI 를 빌드하는 이득을 취할 수 있습니다.

참고: 리브레오피스는 정해둔 규칙에 따르기 위해 패치를 점검할 때 clang-format을 따릅니다. clang-format의 특정 버전을 활용합니다(이렇게 하여 마이너 출시버전 간 그리고 다른 버전간의 비일관성 문제를 해결합니다). 시스템에 clang-format 을 미리 설치해두지 않으면, git commit 을 실행할 때 경고가 뜨며, 필요한 바이너리를 어떻게 설치하는지에 대한 방법도 나타납니다. 어떤 버전을 미리 설치해두었다면, 경고는 뜨지 않거나(다만 일관적이지 못한 결과물로 빌드봇에서 문제가 나타나면 다른 방식으로 포매팅을 바꾸라고 알려줍니다), 미리 설치한 버전이 동작하지 않을 수도 있습니다(명령행 옵션에 문제가 있다는 식으로 메시지가 뜨거나...). 리브레오피스에서 사용하는 버전은 다음 주소에서 찾을 수 있습니다: https://dev-www.libreoffice.org/bin/.

마지막 줄은 특별한 내용이며 master 브랜치의 검토 큐에 대한 리뷰 큐로 이름이 붙은 로컬 브랜치로 모든 패치를 push 합니다(릴리즈 브랜치 또는 다른 브랜치 중 한 곳으로 패치를 제출하려 한다면, 바로 수정하세요). 보통의 기여자분들은 전자메일 주소를 게릿 계정과 맞추셔야합니다. 그렇지 않으면 push할 수 없습니다.

push가 끝나면, git에서 검토 대기중인 주소를 알려줍니다. URL은 https://gerrit.libreoffice.org/#/c/229/ 비스무레하게 나타냅니다.

패치를 검토하는 중에는 패치의 새 버전을 쉽게 올릴 수 있도록 로컬 브랜치를 그대로 두는게 좋습니다. 그 동안에

git checkout master

명령으로 마스터 브랜치로 돌아올 수 있... 고 위 과정을 통해 다른 패치 작업을 시작할 수 있습니다(로컬 브랜치를 만들고, 코드 작성후, 제출, 그리고 게릿으로 push).

패치 제출 더 보기

위 내용 말고도, Development/GitReviewen에서 설명하는대로 "git review" 명령을 사용해볼 수 있습니다.


Development/gerrit/SubmitPatch/ko에서 다음 내용을 찾아볼 수 있습니다.

  • 새 버전 제출
  • 초안 패치 제출

Development/Submodulesen에서 하위 모듈에 패치하는 방법에 대해 다음 내용을 찾아볼 수 있습니다.

  • 사전
  • helpcontent2 (도움말 파일)
  • 번역

게릿 참고자료 더 보기

그 외 읽을거리