복잡한 문제는 나눠서 단순화: 카카오페이 위키 마이그레이션 회고

카카오페이는 독립적인 문서 관리와 보안을 위해 기존 카카오 위키에서 전용 Confluence로의 마이그레이션을 추진했다. 하지만 XML 파싱 오류, 한글 인코딩 깨짐, 첨부 파일 누락 등 예상치 못한 기술적 문제들이 발생하며 운영 일정이 연기되는 난관을 겪었다.

가장 까다로웠던 점은 Confluence 임포트 시 기존의 Page ID가 유지되지 않고 새로운 키가 생성된다는 점이었다. 이를 해결하기 위해 문제를 콘텐츠와 첨부 파일로 분리하여 접근하는 전략을 세웠다.

• 콘텐츠 분리 임포트: 첨부 파일을 제외한 XML 데이터만 먼저 임포트하여 성공적으로 완료했다.
• 매핑 테이블 구축: 기존의 Space ID 및 Page ID와 새로 생성된 키를 연결하는 임시 테이블을 생성했다.
• 자동화 프로그램 개발: Python과 Java를 이용해 매핑 테이블을 기반으로 첨부 파일을 복사하고 DB에 등록하는 프로그램을 개발하여 적용했다.

이러한 단계적 접근을 통해 마이그레이션을 성공적으로 마쳤으며, 카카오페이는 독자적인 Jira 및 Wiki 운영 기반을 확보하게 되었다.