Notion에 GitHub 연결하기

관리형 GitHub 동기화를 통해 선택한 GitHub 작업(풀 리퀘스트, 이슈 또는 둘 다)을 Notion으로 가져올 수 있습니다. Notion은 기존 레코드를 가져오고 백그라운드에서 GitHub의 업데이트를 확인합니다.

이 가이드는 GitHub 연결 설정의 데이터베이스 동기화를 다룹니다. 동기화된 속성은 읽기 전용입니다. 풀 리퀘스트와 이슈는 GitHub에서 변경하세요.

GitHub 앱 설치를 통해 사용 가능한 리포지토리에서 Notion으로 가져올 항목(풀 리퀘스트, 이슈 또는 둘 다)을 선택하세요. 선택한 리포지토리의 데이터가 Notion으로 가져와집니다.

작성자(GitHub) 속성에는 GitHub 사용자 이름이 포함됩니다. 작성자는 작성자의 공개 이메일이 워크스페이스 멤버와 일치할 때 Notion 사용자 속성으로 표시됩니다.

설명 속성은 GitHub에 작성된 그대로의 풀 리퀘스트 설명을 일반 텍스트로 동기화합니다. 마크다운으로 렌더링되지 않습니다.

GitHub 이슈를 단독으로 동기화하거나 풀 리퀘스트와 함께 동기화할 수 있습니다. 이 동기화에는 풀 리퀘스트 댓글이나 검토 세부 정보는 포함되지 않습니다.

필요한 항목:

• Notion 워크스페이스 멤버십.

• 동기화하려는 리포지토리에 사용 권한이 있는 GitHub 계정.

• 해당 리포지토리에 사용 권한이 있는 GitHub 앱 설치.

• 비즈니스 요금제(모바일 비즈니스 포함). GitHub 동기화는 다른 요금제에서는 사용할 수 없습니다.

GitHub 계정과 앱 설치 모두 사용 권한이 필요합니다. GitHub 조직의 경우 담당자가 앱을 승인하거나 설치해야 할 수도 있습니다.

1. Notion에서 설정 → 연결 → GitHub로 이동하세요.

2. 데이터베이스 동기화를 열고 아직 연결하지 않았다면 GitHub 계정을 연결하세요.

3. GitHub의 인증 및 설치 단계를 완료하세요.

4. 동기화할 저장소가 있는 조직이나 계정을 선택하세요. 다른 설치를 추가해야 하는 경우 조직 추가…를 사용하세요.

5. 포함할 저장소를 선택하세요.

6. 동기화 이름을 지정하고 Notion으로 가져올 항목(풀 리퀘스트, 이슈 또는 둘 다)을 선택하세요.

7. 사용 가능한 모든 기록 또는 특정 기록 기간을 선택하세요.

8. 동기화 생성을 선택하세요.

Notion은 사이드바의 개인 페이지 섹션에 동기화된 데이터베이스를 만들고 일치하는 레코드를 가져오기 시작합니다.

처음 가져올 때 Notion은 선택한 각 리포지토리에서 동기화 대상으로 선택한 풀 리퀘스트와 이슈를 읽어옵니다. 가장 최근에 업데이트된 항목부터 선택한 기록 범위까지 순서대로 가져옵니다.

가져오기가 완료되면 Notion은 정기적으로 각 리포지토리에서 새 레코드와 업데이트된 레코드를 확인합니다. 새 라벨, 닫힌 풀 리퀘스트, 다시 열린 이슈와 같은 변경 사항은 Notion의 해당 속성을 업데이트합니다.

Notion을 닫아도 동기화는 계속 실행됩니다. 대규모 저장소, GitHub 요청 제한, 일시적인 서비스 문제로 인해 업데이트가 지연될 수 있습니다. 동기화 상태를 확인하여 진행 상황이나 오류를 확인하세요.

모든 기록, 최근 30일, 최근 90일 또는 최근 365일을 선택하세요. 모든 기록 동기화가 토글로 제공되는 경우, 사용 가능한 모든 기록 동기화를 켜두어 사용 가능한 모든 풀 리퀘스트를 포함하세요.

이 기간은 풀 리퀘스트의 업데이트 시간을 기준으로 합니다. 풀 리퀘스트가 생성된 시점이나 열림, 닫힘, 병합 여부와는 관계가 없습니다.

예를 들어, 90일 넘게 변경되지 않은 미해결 풀 리퀘스트나 이슈는 90일 기간에서 제외될 수 있습니다.

설정 → 연결 → GitHub → 데이터베이스 동기화에서 동기화를 여세요.

• 이슈 또는 풀 리퀘스트 추가/삭제: 동기화할 항목을 변경하고 ‘변경 사항 저장’을 선택하세요. 유형을 추가하면 해당 레코드를 가져옵니다. 유형을 제외하면 해당 페이지가 삭제됩니다. 유지하는 유형에 대해 이미 가져온 레코드는 그대로 남습니다.

• 저장소 추가: 선택 항목을 편집하고 변경 사항 저장을 선택하세요. Notion이 추가된 저장소에서 일치하는 풀 리퀘스트를 가져옵니다.

• 저장소 제거: 선택을 해제하고 저장하세요. 동기화된 풀 리퀘스트 페이지가 Notion에서 제거됩니다.

• 변경 기록: 기간을 길게 설정하면 더 많은 녹음이 가져와집니다. 기간을 짧게 설정하면 새 기간 범위를 벗어나는 녹음이 제거됩니다.

• 업데이트 일시정지:동기화 일시정지를 선택하세요.

• 업데이트 재개: 동기화를 계속하려면 동기화 재개를 선택하세요.

저장소를 제거하거나 기록을 단축하기 전에, 영향을 받는 페이지에서 필요한 Notion 전용 정보를 보관해 두세요.

리포지토리, 상태, 작성자 또는 라벨별로 보기를 만드세요. 나만의 속성을 추가해 릴리스 준비 상태를 추적하거나 풀 리퀘스트와 이슈를 팀의 계획 프로세스와 연결할 수 있습니다. 직접 추가한 속성 값은 Notion에 남습니다.

GitHub 속성을 변경하려면 GitHub URL을 통해 해당 레코드를 열고 GitHub에서 변경하세요.

데이터베이스는 처음에 개인 페이지로 시작됩니다. 데이터베이스를 공유하면 Notion의 공유 설정에 따라 가져온 데이터를 볼 수 있는 사용자가 결정됩니다. 뷰어마다 출처 리포지토리에 대한 사용 권한이 필요한 것은 아니므로, 개인 페이지 리포지토리 정보를 공유하기 전에 데이터베이스의 권한을 검토하세요.

올바른 GitHub 계정과 앱 설치를 선택했는지 확인하세요. 계정과 앱 모두에 저장소 사용 권한이 있는지 확인하세요. 조직에서 앱 설치를 제한하는 경우, 담당자에게 사용 권한 승인을 요청하세요.

동기화의 저장소 설정을 열고 저장소 선택을 검토한 후 다시 저장하세요. 다른 조직으로 이동한 경우, 새 위치에서 연결에 대한 사용 권한이 있는지 확인하세요.

GitHub 사용자 이름에 Notion 워크스페이스 멤버와 일치하는 공개 이메일이 항상 있는 것은 아닙니다. 사람 속성이 비어 있을 때 작성자를 식별하려면 작성자 (GitHub)을 사용하세요. 작성자의 이메일이나 워크스페이스 멤버십이 변경되어도 이전의 동기화된 풀 리퀘스트는 자동으로 새로고침되지 않을 수 있습니다.

해당 유형이 동기화에 포함되었는지, 리포지토리가 선택되었는지, 마지막 업데이트가 기록 기간 내에 있는지, Notion 보기에서 필터링되고 있지 않은지 확인하세요. 첫 번째 가져오기가 아직 진행 중일 수 있습니다.

동기화 상태 세부 정보를 확인하세요. 메시지가 표시되면 GitHub 계정을 다시 연결하거나 리포지토리 사용 권한을 복원하세요. GitHub 요청 제한 및 일시적인 중단으로 인해 Notion이 재시도하는 동안 업데이트가 지연될 수 있습니다.

Workers와의 비교 및 공유 문제 해결 지침은 다른 도구에서 Notion으로 데이터 동기화 →를 참조하세요.