-
GitHub Token 생성
-
issues-notion-sync Notion 템플릿 복제
-
Notion API 통합 시크릿 생성
👉 Notion API 통합 | Notion 도움말 센터
-
프로젝트 최상위에
.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
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)
…
GitHub PR - Notion 작업 연동
-
Notion - GitHub 워크스페이스 앱 연결 ⭐
- 사이드바
설정
- '내 연결' 클릭 후
GitHub (Workspace)
찾기 - GitHub 계정 및 Repository 연결
- 사이드바
-
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