GitHub 통합

Notion의 API로 GitHub와 통합하면 개발 워크플로를 원활하게 연결할 수 있습니다. 예를 들어, Notion 페이지에서 바로 GitHub 콘텐츠를 연결하고, GitHub 정보를 Notion 데이터베이스에 가져오고, 풀 리퀘스트를 Notion 작업과 동기화하여 팀원들에게 프로젝트 상태를 계속 알릴 수도 있습니다. 계속해서 읽어보면서 다양한 API 통합 기능과 설정 방법을 알아보세요.

Notion 워크스페이스 소유자이면서 GitHub 조직 관리자인 사람만 Notion과 GitHub 워크스페이스 앱을 연결할 수 있습니다.

1. 사이드바의 설정으로 이동하세요.

2. 내 연결을 클릭하고 GitHub(워크스페이스)을 찾으세요.

3. 연결을 클릭하고 인증 절차를 완료하세요.

Notion의 파일 또는 파일의 특정 라인으로 바로 링크하세요. 최신 버전의 코드 참조를 원한다면 특정 커밋 또는 브랜치를 링크할 수도 있습니다.

1. GitHub에서 원하는 줄의 permalink를 복사하세요.

2. Notion 페이지에 붙여넣고 미리보기로 붙여넣기를 선택하여 페이지에 코드를 임베드하세요.

GitHub 리포지토리(풀 리퀘스트와 이슈 포함)를 Notion에 데이터베이스로 동기화할 수 있습니다. 아래 방법에 따라 진행하세요.

1. GitHub의 경우 PR이나 이슈 링크를 복사하세요.

2. Notion에 링크를 붙여넣고 데이터베이스로 붙여넣기를 선택합니다.

   • 아직 로그인하지 않았다면 GitHub 계정으로 로그인하고 Notion에 연결하라는 메시지가 표시됩니다.

3. 동기화된 데이터베이스는 표 보기로 생성되며 GitHub 속성이 모두 자동으로 추가됩니다.

4. 데이터베이스는 자동으로 추가되기 시작하며 페이지를 벗어나도 계속 동기화됩니다.

Notion에서 지원하는 GitHub 속성은 아래와 같습니다.

현재 라벨과 태그는 지원되지 않습니다.

ID 매핑을 사용하여 GitHub ID를 팀의 Notion 프로필에 연결할 수 있습니다. 아래 방법에 따라 진행하세요.

1. GitHub 이메일 설정으로 이동하여 내 이메일 주소를 비공개로 유지가 선택되어 있지 않은지 확인하세요.

2. 자신의 GitHub 프로필(https://github.com/{YOUR_USERNAME_HERE})에서 프로필을 수정하여 Notion 이메일 주소를 추가하세요.

이렇게 하면 멤버로 있는 워크스페이스의 동기화된 데이터베이스에 ID를 매핑할 수 있습니다.

Notion 데이터베이스 안의 GitHub 풀 리퀘스트 속성은 협업팀들에게 작업 상태를 자동으로 알려줍니다. 롤업, 수식, 필터 등에 사용할 수 있는 여러 속성도 함께 활용하세요.

1. Notion 데이터베이스에서 +를 클릭하여 새로운 속성을 추가하세요.

2. 이 속성을 데이터베이스에 추가하려면 GitHub 풀 리퀘스트를 검색하고 클릭하세요.

3. 데이터베이스에는 고유 ID 속성이 있어야 합니다. 고유 ID 속성이 없으면 이 속성이 데이터베이스에 추가됩니다.

4. GitHub 풀 리퀘스트 속성을 사용하려면 GitHub 계정을 Notion에 연결했는지 확인하세요. 그 다음, 풀 리퀘스트에 Notion 작업의 고유 ID를 추가하거나 GitHub 풀 리퀘스트 URL을 속성에 붙여넣으세요.

Notion 작업에서 GitHub로의 백링크가 기본적으로 허용됩니다. 이 기능을 해제하려면 데이터베이스에서 GitHub 풀 리퀘스트 속성 → 속성 편집을 클릭하고 GitHub에서 링크백 토글을 끄세요.

GitHub 풀 리퀘스트 속성을 사용하여 Notion에서 작업 상태를 자동으로 업데이트할 수 있습니다.

1. GitHub 풀 리퀘스트 속성의 제목을 선택하고 속성 편집을 클릭하세요.

2. 자동 업데이트 섹션을 찾아 드롭다운 메뉴에서 업데이트할 상태 속성을 선택하세요.

3. GitHub PR의 상태가 오픈, 리뷰 요청, 승인됨, 머지됨일 때 Notion에 설정될 작업 상태를 선택하세요.

4. 이제 GitHub에서 PR 상태가 변경되면 Notion 작업 상태도 설정에 따라 자동으로 업데이트됩니다.

링크된 Notion 작업에서 GitHub 활동을 표시할 수도 있습니다. 데이터베이스의 GitHub 속성 → 속성 편집을 클릭하고 활동 코멘트를 활성화하세요.

GitHub PR을 하나 이상의 Notion 작업에 링크하려면 PR의 설명에 매직워드와 Notion 작업의 고유 ID를 입력하세요.

매직워드는 Notion 작업과 GitHub PR 간의 관계 설정을 돕는 핵심 단어입니다. 다음과 같은 단어를 사용하세요.

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• related to

• contributes to

• towards

예를 들어 PR 설명에 'CTT-13 수정'을 넣을 수 있습니다. 해당 설명이 설정되면 ID가 CTT-13인 Notion 작업은 해당 PR과 링크됩니다.

PR 설명에 작업 종료 또는 완료가 연상되는 매직워드를 사용하는 경우, PR이 머지될 때 Notion 작업이 완료된 것으로 표시됩니다.

PR 설명에 작업 참조나 관련이 연상되는 매직워드를 사용하는 경우, PR이 머지될 때 Notion 작업이 완료된 것으로 표시되지 않습니다.

또한, Notion 작업을 참조 전용으로 링크하면 해당 작업이 완료된 것으로 표시되지 않습니다.

Notion에서 GitHub 연결을 해제하려면 Notion 워크스페이스 소유자이어야 합니다.

1. 설정으로 이동하세요.

2. 연결을 선택하세요.

3. GitHub 옆의 ••• → 모든 사용자 연결 해제를 선택하세요.

Notion에서 GitHub 연결을 해제하면 다시 설정할 때까지 워크스페이스의 누구도 API 통합을 사용할 수 없습니다.