이 문서는 Notion을 Confluence 마이그레이션하는 가이드를 공유하기 위해 작성되었다.
마이그레이션은 커브에서 개발한 마이그레이션 도구를 통해 진행됩니다. 해당 마이그레이션 도구 사용을 위해서는 아래 문의하기를 통해 요청 부탁드립니다.
마이그레이션 도구의 한계
- Notion에서 다운로드 받은 마크업 포멧을 Confluence Cloud Import 합니다. 일반적이지 않은 마크업 언어 일부는 지원이 되지 않습니다.
- Notion의 데이터베이스는 지원이 되지 않습니다. 노션에서 Export되는 CSV 파일은 Confluence에서 무시됩니다.
- 하위페이지 구조를 가져가기 위해서는 Notion에서 하위페이지를 폴더로 생성하여 Export 해주세요.
사전 준비사항
Node 및 npm 설치
Notion을 Confluence로 마이그레이션은 Node JS를 통해 진행됩니다. 최소 아래 버전의 node.js와 npm이 필요합니다.
- Node v18.17.1
- NPM v9.6.7
마이그레이션 도구 요청
커브 문의하기를 통해 notion2confluence 프로그램 사용을 요청합니다.
- notion2confluence.zip
마이그레이션 도구 압축 해제
공유 받은 notion2confluence 파일을 적절한 위치에 압축을 해제합니다.
노션 내보내기
다운로드 할 노션을 Markdown & CSV로 선택하여 다운로드 받습니다.
Notion to Confluence 마이그레이션 수행
마이그레이션 도구 설치
상단 마이그레이션 도구의 압축 해제 폴더로 이동하여 터미널에서 다음 명령을 수행합니다.
npm install
다음과 같이 마이그레이션 도구 설치가 진행되는 것을 확인할 수 있습니다.
.env 세팅
설치가 완료되면 .env 파일을 수정 모드로 열고 다음 값을 업데이트 합니다.
- USER_NAME - Atlassian Cloud 사용자 계정 (이메일 주소)
- USER_TOKEN - Atlassian Cloud 사용자 토큰
- CONFLUECE_SPACE_KEY - 마이그레이션 대상 Confluence 공간 키
마이그레이션 실행
모든 설정이 완료되면 다음 명령을 수행하여 마이그레이션을 진행합니다.
node main.js -f "notion markup 위치"
마이그레이션 진행 현황
상단 명령을 수행하면 다음과 같이 마이그레이션이 진행됩니다.
마이그레이션 결과
Confluence로 이동하여 최종 마이그레이션 결과를 확인합니다.
