GitHub 연동 안내서

1. 1

   왼쪽 위 워크스페이스 이름을 눌러 워크스페이스 설정을 열고 기타 탭으로 이동합니다.

2. 2

   GitHub 설치 연결 카드에서 설치 연결을 누릅니다. 이미 연결된 설치가 있으면 설치 추가를 누릅니다.

3. 3

   GitHub 화면에서 승인합니다. 기타 탭으로 돌아와 「GitHub 설치를 연결했습니다.」가 보이면 완료입니다.

4. 4

   앱이 아직 설치되지 않았다면 「연결할 수 있는 GitHub 설치가 없습니다.」가 나옵니다. GitHub에서 앱 설치를 눌러 설치합니다. 조직에 설치하려면 그 조직의 Owner 권한이 필요합니다.

이 승인으로 내 GitHub 계정 연결(3단계)도 함께 이루어집니다. 다른 GitHub 계정으로 승인하면 GDC에 연결된 계정이 그 계정으로 바뀌며, 카드에 안내가 표시됩니다.

1. 1

   설치 해제는 이 설치를 쓰는 워크스페이스의 모든 프로젝트 연동을 끝냅니다. 레포 연결과 이슈 연결은 보관되며, 다시 연결을 누르면 그대로 복원됩니다.

2. 2

   GitHub에서 앱도 제거하기를 함께 선택하면 GDC의 레포 접근 권한이 완전히 회수됩니다. 다시 쓰려면 앱을 새로 설치해야 하며 조직 관리자 권한이 필요합니다.

3. 3

   설치 하나는 워크스페이스 하나에만 연결할 수 있습니다. 다른 워크스페이스로 옮기려면 기존 워크스페이스에서 먼저 해제합니다.

1. 1

   프로젝트에서 연동 탭을 열고 GitHub 레포 연동 영역을 찾습니다.

2. 2

   레포 추가를 누르고 레포를 고른 뒤 다음을 누릅니다. 이미 연결된 레포는 「연결됨」으로 표시되어 고를 수 없습니다.

3. 3

   이어서 매핑 설정 창(2-2)이 열립니다. 매핑을 저장하면 연결이 완료됩니다.

레포 목록은 워크스페이스 소유자·관리자 권한이 있어야 보입니다. 권한이 없는 프로젝트 관리자에게는 「레포를 찾을 수 없습니다.」로 나오므로 워크스페이스 관리자에게 연결을 요청합니다. 새 프로젝트를 만들 때 「GitHub 레포 연동」을 선택해 대표 레포 하나를 바로 연결할 수도 있습니다.

1. 1

   사이드바 맨 아래(또는 오른쪽 위 프로필 메뉴)의 설정을 열고 연동 탭으로 이동합니다.

2. 2

   GitHub 계정 연결 카드에서 GitHub 계정 연결 버튼을 누르고 GitHub에서 승인합니다.

3. 3

   GDC로 돌아오면 카드에 연결된 계정(@아이디)이 표시됩니다. 끊으려면 연결 해제를 누릅니다. 이미 가져온 태스크는 그대로 남습니다.

계정을 연결하기 전에 가져온 태스크는 프로젝트 관리자가 전체 가져오기(2-4)를 실행해야 작성자·담당자가 바뀝니다. 매칭은 워크스페이스·프로젝트 멤버만 대상이며, 담당자로 매칭되려면 프로젝트 멤버여야 합니다.

1. 1

   태스크의 GitHub 영역에서 이슈 발행을 누릅니다.

2. 2

   레포를 고릅니다(하나뿐이면 자동 선택). 한 번만 옮기고 끝낼 것이 아니라면 발행 후에도 GDC 변경을 GitHub에 계속 반영합니다를 켜 둡니다.

3. 3

   발행을 누릅니다. 잠시 후 이슈가 만들어지며, 이슈 맨 위에 GDC 태스크 링크가 붙습니다.

태스크를 만들 때 「GitHub 이슈로 발행」을 선택해 바로 발행할 수도 있습니다. 본문의 이미지·첨부는 GitHub으로 옮길 수 없어 GDC 링크로 대체됩니다. 라벨은 레포에 같은 라벨이 있을 때만, 담당자는 GitHub 계정을 연결했고 레포 권한이 있을 때만 반영됩니다.

1. 1

   태스크의 GitHub 영역에서 PR 연결을 누릅니다.

2. 2

   최근 PR 목록에서 고르거나, 「목록에 없나요? 번호를 직접 입력하세요.」에 PR 번호를 넣고 연결합니다.

3. 3

   연결된 PR은 상태(open·draft·merged·closed)와 함께 표시됩니다. 해제하려면 PR 줄에 마우스를 올리고 연결 해제를 누릅니다.

PR 상태는 태스크 상태를 바꾸지 않습니다. PR이 병합되어도 태스크가 완료되지 않으니 상태는 직접 바꿉니다.