피드로 돌아가기
I built a Jira Cloud backup tool after Atlassian deprecated theirs and paywalled the replacement
Dev.toDev.to
Backend

Atlassian이 Jira Cloud Backup Manager API를 deprecated하고 유료화한 후, 개발자가 REST API v3를 활용한 오픈소스 백업 도구 구현으로 Standard plan 사용자의 자동 백업 기능 복원

I built a Jira Cloud backup tool after Atlassian deprecated theirs and paywalled the replacement

David Malko2026년 3월 28일1intermediate

Context

Atlassian은 2026년 3월 30일 Jira Cloud Backup Manager API를 deprecated하고 백업 기능을 Premium/Enterprise 플랜의 유료 추가 기능으로 전환했다. 이로 인해 Standard 플랜 사용자는 프로젝트 마이그레이션, 자동 백업, 실수로 인한 대량 변경 복구 등의 작업을 수행할 수 없게 되었다.

Technical Solution

  • REST API v3를 활용한 개별 프로젝트 백업 및 복구: Backup Manager API 대신 표준 REST API로 모든 이슈, 필드 데이터, 변경 이력 캡처
  • 5단계 순차 복구 프로세스: 에픽(1단계) → 일반 이슈(2단계) → 서브태스크(3단계) → 링크(4단계) → 댓글 및 워크로그(5단계) → 첨부파일(6단계) 순서로 처리
  • 중단-재개 가능한 복구 메커니즘: 동일한 복구 명령 재실행 시 이미 처리된 아이템은 건너뜀
  • Dry-run 모드: API 호출 없이 모든 작업을 사전 검증
  • 교차 인스턴스 마이그레이션: 한 조직의 백업을 다른 Jira 인스턴스로 복구 가능
  • 자동 정리 및 선택적 건너뛰기: 불완전한 부분 폴더 제거, --skip-existing 플래그로 완료된 백업 건너뜀

Key Takeaway

폐쇄된 상용 API 대신 공개 표준 API(REST API v3)를 활용하면 기업의 정책 변경에 독립적인 자체 솔루션을 구축할 수 있으며, 이러한 도구를 오픈소스로 공개함으로써 같은 문제를 겪는 사용자 커뮤니티의 요구를 해결할 수 있다.


Jira Cloud Standard 플랜의 시스템 관리자는 jira-project-backup-restore를 pip install로 설치한 후 'python main.py --backup PROJ --skip-existing'으로 자동화된 정기 백업을 구성할 수 있으며, 이를 통해 플랜 업그레이드 비용 없이 프로젝트 마이그레이션 및 재해 복구 능력을 확보할 수 있다.

원문 읽기