Issues Notion Sync

     

1. Requirements

• GitHub Token 생성

• issues-notion-sync Notion 템플릿 복제

• Notion API 통합 시크릿 생성
  👉 Notion API 통합 | Notion 도움말 센터

2. Settings

• 프로젝트 최상위에 .github 폴더 위치

• 복제한 issues-notion-sync 페이지에 Notion API 연결
  👉 API 통합 추가와 관리 - 페이지에 연결 추가 | Notion 도움말 센터

• Notion 페이지 ID 추출
  👉 Build your first integration - Environment variables | Notion Developers

• GitHub Repository secrets 설정

  GH_TOKEN: GitHub Token
  NOTION_API_KEY: 사용자의 프라이빗 Notion API 통합 시크릿
  NOTION_DATABASE_ID: 사용자가 복제한 GitHub issues 페이지 ID
  

3. (Optional) Custom Properties

issues-notion-sync 페이지의 기본 속성과 데이터 형식, 설명 → Notion API 활용 커스텀 가능

속성	데이터 형식	설명
Status	선택	Issue 상태(Opened, Closed)
Title	제목	Issue 제목
Assignees	다중 선택	Issue 담당자
Labels	다중 선택	Issue 레이블 목록
Date	날짜	Issue 생성 ~ 종료 기간 (시간 포함 / TIMEZONE 설정 기준)
Link	URL	Issue 바로가기 링크

# [.github/workflows/notion.yml]
# 135 ~ 162 Lines

…

body=$(jq --arg title "$ISSUE_TITLE" --arg link "$ISSUE_URL" '. + {
  properties: {
    Status: {
      select: {
        name: "${{ steps.properties.outputs.status }}"
      }
    },
    Title: {
      title: [{
        text: {
          content: $title
        }
      }]
    },
    Assignees: {
      multi_select: ${{ steps.properties.outputs.assignees }}
    },
    Labels: {
      multi_select: ${{ steps.properties.outputs.labels }}
    },
    Date: {
      date: ${{ steps.properties.outputs.date }}
    },
    Link: {
      url: $link
    }
  }
}' body.json)

…

4. (Optional) Link to GitHub PR

GitHub PR - Notion 작업 연동

• Notion - GitHub 워크스페이스 앱 연결 ⭐

  1. 사이드바 설정
  2. '내 연결' 클릭 후 GitHub (Workspace) 찾기
  3. GitHub 계정 및 Repository 연결

  👉 GitHub 통합 - GitHub API 통합 설정 | Notion 도움말 센터

• issues-notion-sync 페이지에서 연동하고자 하는 작업의 ID 확인

  (Default) ISSUE-*

• PR 설명에 매직워드 + ID 입력

  ex) ref ISSUE-1, fix ISSUE-1, …

  👇 매직워드 종류

  · close, closes, closed
  · fix, fixes, fixed
  · resolve, resolves, resolved
  · complete, completes, completed, completing
  · ref, references
  · part of
  · related to
  · contributes to
  · towards
  

✔️ 공식 문서를 보고싶다면?
      GitHub 통합 - 매직워드를 사용하여 GitHub PR을 Notion 작업에 링크하기 | Notion 도움말 센터

✔️ 구체적인 예시가 보고싶다면?
      샘플 PR

Reference

• Notion Developers
• Notion 도움말 센터